nestjs-best-practices

此技能作为 NestJS 11+ 开发者的全面知识库，专为使用 TypeScript 构建稳健、可扩展的企业级应用程序而设计。它弥补了官方文档与实际生产实现之间的差距，提供从模块架构到微服务协调的完整应用生命周期指导。该技能专为需要确保大规模 Node.js 项目的一致性、类型安全和简洁代码原则的高级开发人员和架构师而设计。

• 进阶依赖注入模式，包含 forwardRef、自定义提供者与动态模块配置。

• 通过中间件、守卫、拦截器、管道与全局异常过滤器进行请求生命周期管理。

• 使用 class-validator、class-transformer 与自定义 ValidationPipes 进行输入验证与数据转换。

• 利用 JWT、Passport 与基于角色的访问控制 (RBAC) 实现强大的身份验证与授权机制。

• 支持 TypeORM、Prisma 与 Drizzle ORM 的数据库整合，包含存储库模式与迁移安全性。

• 涵盖单元测试、端对端 (E2E) 测试与整合测试，并提供提供者模拟技巧。

• 支持跨 TCP、Redis、NATS 与 Kafka 传输层的企业级微服务架构。

• 具备 OpenAPI 与 GraphQL 文档生成模式，并遵循装饰器与解析器最佳实践。

• 适用于重构旧版 NestJS 代码或架构新功能模块时使用。

• 提供常见错误检查，例如循环依赖、不当的单例作用域与缺少白名单验证。

• 协助导航 NestJS 11 的重大变更，包含 Express v5 与 Fastify v5 的迁移路径。

• 通过落实健康检查、ConfigService 实现与正确的环境设置，确保应用程序的生产环境就绪。

• 协助除错依赖解析错误以及性能关键的微服务通讯设置。