Nest.js切换Fastify报错：NestFastifyApplication不满足INestApplication约束

问题根源 #

你的Nest.js依赖版本不兼容：@nestjs/platform-fastify是v10.0.3，但核心的@nestjs/core、@nestjs/common等包是v9.4.3。跨大版本的类型定义不匹配，导致泛型约束校验失败。

解决方案 #

统一所有Nest.js相关包的版本，二选一即可：

• 方案一：升级核心包到v10
  执行以下命令，将所有核心依赖同步到v10版本：

  npm install @nestjs/core@10 @nestjs/common@10 @nestjs/testing@10 @nestjs/mapped-types@2
  

• 方案二：降级platform-fastify到v9
  执行以下命令，将fastify平台包降级到与核心包匹配的v9版本：

  npm install @nestjs/platform-fastify@9
  

安装完成后重新启动项目，类型错误即可解决。

额外提示 #

后续安装Nest.js相关包时，尽量保持版本一致，避免跨大版本混用。可以在package.json中使用^锁定大版本范围（比如^9.x.x），确保依赖版本兼容性。

内容的提问来源于stack exchange，提问作者L.LK