pnpm+nx monorepo升级NestJS至v11后出现UnknownDependenciesException

针对pnpm+nx monorepo中升级NestJS到v11后出现的依赖解析失败问题，按以下步骤排查修复：

• 清理缓存并强制重装依赖
  pnpm和nx的缓存可能残留旧版本依赖，引发冲突。执行以下命令：

  pnpm store prune
  pnpm install --force
  nx reset
  

• 确保所有NestJS生态包版本完全统一
  检查根目录package.json的pnpm override配置，必须覆盖所有@nestjs相关包（包括附属模块如mongoose、schedule），版本要与@nestjs/core严格匹配：

  "pnpm": {
    "overrides": {
      "@nestjs/common": "11.0.0",
      "@nestjs/core": "11.0.0",
      "@nestjs/mongoose": "^11.0.0",
      "@nestjs/schedule": "^11.0.0",
      "rxjs": "^7.8.1",
      "typescript": "5.4.5"
    }
  }
  

  注意：v11的NestJS要求附属模块也升级到对应v11版本，旧版附属包会导致依赖解析失败。

• 修正TypeScript配置
  NestJS v11对TS模块解析要求更严格，检查根目录及子项目的tsconfig.json：

  • 将moduleResolution设为NodeNext或Node16
  • 把skipLibCheck设为false，避免跳过类型检查掩盖依赖问题
  • 子项目tsconfig必须继承根目录配置，保证全局配置一致

• 调整NX项目构建顺序
  monorepo中服务依赖的库未提前构建会导致模块解析失败。修改报错服务的project.json，确保构建依赖前置：

  "targets": {
    "build": {
      "dependsOn": ["^build"]
    }
  }
  

  尝试单独构建报错服务，查看是否有模块缺失警告：

  nx build <你的服务名称>
  

• 排查自定义模块的依赖注入
  检查自定义模块的@Module()装饰器，确认是否正确导入MongooseCoreModule、Scheduler相关模块，避免循环依赖或遗漏导入。比如根模块要正确配置MongooseModule.forRoot()，子模块按需导入MongooseModule.forFeature()即可，无需重复导入核心模块。

内容的提问来源于stack exchange，提问作者Siggi36