NestJS 工程专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-nestjs-expert。
技能介绍
你在 NestJS 里常踩的坑
生产里的 NestJS 服务一旦堆上 MongoDB/Mongoose、全局校验和鉴权,就容易出现「控制器里写业务」「读查询不用 .lean()」「process.env 散落各处」这类问题。它们不体现在教程示例里,却会在 Code Review 和压测阶段集中暴露。
技能如何约束你的实现
这份约定以 TypeScript 严格模式 为底线,要求功能按 自包含 Module 拆分:跨模块只走导出的 Provider,尽量避免 forwardRef 掩盖循环依赖。
- 控制器:只做路由与入参绑定;
@Body()/@Query()/@Param()一律用 DTO;用自定义@CurrentUser(),不用@Req()掏user。 - 校验:在
main.ts挂全局ValidationPipe,让非法入参在边界被挡住。 - Mongoose:读路径默认
.lean().exec();服务层引用用Types.ObjectId;用户数据 软删除(deletedAt),不做硬删。 - 配置与观测:环境变量只在 Config 模块经
ConfigService读取;日志用new Logger(ClassName.name),不用console.log。 - 性能:为
find/sort涉及的字段建索引,多字段查询考虑复合索引;大文档用select()投影;昂贵读可走@nestjs/cache-manager。 - 测试:用
Test.createTestingModule,外部依赖一律 Mock。
文末对照表把「业务逻辑进 Controller」「到处 any」等反模式与正确做法并排,方便在改代码时快速自检。
适用边界
它覆盖典型 REST + MongoDB 单体/模块化后端惯例,不替代 BullMQ 队列设计、Mongo 迁移脚本或全局错误策略的专项技能;那些场景应结合文档里列出的关联技能单独处理。
使用场景
- 新接口要接 JWT 鉴权,需统一 Guard、@CurrentUser() 与 DTO 校验,避免在控制器里读 req.user
- Mongo 列表接口变慢,需按 find/sort 字段补索引并在读查询上统一 .lean().exec()
- 多 Module 互相引用触发循环依赖,需按导出 Provider 拆边界而非到处 forwardRef
- Code Review 发现控制器直连 Mongoose,需把业务与持久化迁回 Service 并补齐测试 Module Mock
适合人员
- 用 NestJS + Mongoose 交付 REST 的后端工程师,希望在团队内统一 Module 边界与 DI 写法
- 负责 API 性能的后端,需要在 Mongoose 读路径上落实 lean、索引与 select 投影规范
- 带 Nest 代码库的 Tech Lead,要在 PR 中系统性揪出 any、硬删与 process.env 直读
- 刚接入全局 ValidationPipe 的项目成员,需要把入参 DTO 与异常过滤器职责划清楚