NestJS 11.0版本更新内容

NestJS 11.0 是 Nest 框架的一次重要版本升级，引入了多项新特性、性能优化和兼容性改进。以下是其主要更新内容的总结：

---

1. 日志增强

• JSON 日志支持：新增内置的 JSON 日志格式输出，适合容器化环境，可通过配置 json: true 启用。同时支持保留颜色输出以方便本地开发。
• 格式化改进：支持深层嵌套对象、数组、Map 和 Set 的格式化，并允许自定义日志前缀。

---

2. 微服务灵活性提升

• 底层客户端访问：新增 unwrap() 方法，允许直接获取微服务传输器（如 NATS、Kafka、Redis）的底层客户端实例，便于执行自定义操作。
• 事件监听与状态流：通过 on() 方法可监听底层客户端事件（如断开连接），并通过 status 可观察流实时获取客户端状态更新。
• ClientProxy API 统一：所有微服务传输器的 ClientProxy 类均支持上述方法，确保一致性。

---

3. 应用启动速度优化

• 模块键生成机制改进：不再使用哈希函数生成动态模块的键，而是基于对象引用，显著减少启动时间，尤其在处理大型 JSON 配置时性能提升明显。
• 动态模块实例行为变更：相同配置的动态模块会被视为不同实例（之前可能合并），若需保留单例行为，需显式复用模块变量。

---

4. 对 Express v5 和 Fastify v5 的支持

• Express v5 路由调整：
  • 通配符路由需命名，如 /*splat 或 /{*splat}，旧语法 /* 可能失效。
  • 移除对 ? 可选字符的支持，改用大括号语法（如 /:file{.:ext}）。
• Fastify v5 兼容性：升级更平滑，但需注意底层库的变更影响。

---

5. 其他关键改进

• 生命周期钩子顺序调整：终止钩子（如 OnModuleDestroy、OnApplicationShutdown）的执行顺序被反转。
• 依赖注入与配置增强：
  • 新增 ParseDatePipe，简化日期参数处理。
  • ConfigService 支持覆盖 process.env 值，并引入 skipProcessEnv 选项以隔离配置。
• 模块与工具更新：
  • CacheModule 升级至 cache-manager v6，使用 Keyv 作为统一存储接口。
  • @nestjs/cqrs 支持请求作用域提供者及强类型命令/事件。

---

迁移注意事项

• Express v5 路由兼容性：需检查并调整通配符路由语法。
• 动态模块实例化：若依赖旧版合并行为，需手动复用模块变量。
• 官方迁移指南：建议参考 NestJS 文档提供的详细步骤，确保平滑过渡。

---

总结

NestJS 11.0 在日志、微服务、性能、HTTP 框架支持等方面均有显著提升，同时保持了向后兼容性。开发者可重点关注 JSON 日志、微服务 API 扩展及 Express v5 的适配调整。如需完整变更列表，可查阅 NestJS 官方迁移指南。