NestJS专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-nestjs-expert。
技能介绍
要解决什么问题
用 NestJS 写 API 时,常见问题往往不是「不会写路由」,而是约定没对齐:模块边界乱、依赖手动 new、写接口没守卫、入参没校验、异常被 try/catch 吞掉或把堆栈直接返回客户端。启动阶段还会出现 Nest can't resolve dependency、模块间循环依赖导致应用起不来。本技能针对这些可复现的工程痛点,而不是泛泛介绍框架官网目录。
技能如何工作
技能按 NestJS 的请求生命周期组织输出:模块与 DI(@Module、providers、exports、前向引用解循环)、守卫与 DTO(@UseGuards、RolesGuard、class-validator + 全局 ValidationPipe)、异常处理(语义化 HTTP 异常 + @Catch 过滤器统一 {code,message,traceId})、以及拦截器等钩子该挂在哪一层。输入通常是业务域、路由或入参形状;输出是可直接套用的 @Module 结构、守卫片段、DTO 类与过滤器模板,并附带「常见卡点 / 自救」对照表。
适用边界与注意点
技能只提供框架用法、代码片段与陷阱库,不接入付费服务、不涉及外部账号或密钥,也不替代你对业务安全与合规的最终判断。生产环境须遵守:鉴权失败返回 401、响应中不泄露堆栈与敏感配置;具体业务鉴权策略仍由项目自行负责。
使用场景
- 新业务域(如订单)要拆成独立 Module,并正确注入 Repository 与跨模块共享服务
- 写接口需 JWT + 角色鉴权,要确定守卫挂在 Controller 还是路由及与 `@Roles` 的配合
- 入参校验未生效或前端多传字段进入对象,需配置 ValidationPipe 与 whitelist
- 业务异常被局部 catch 后只打日志,接口统一返回 500,需用过滤器归一响应
适合人员
- 从 Express 迁到 Nest、需要控制器/服务/模块分层规范的 Node 后端工程师
- 启动报 can't resolve dependency 或循环依赖、需梳理 providers 与 imports 的项目维护者
- 负责对外 API、要写接口守卫与 DTO 但不确定全局 ValidationPipe 如何开启的开发者
- 生产异常响应格式混乱或泄漏堆栈、需统一 `@Catch` 过滤器的 Tech Lead