NestJS依赖冲突求助：安装@nestjs/microservices时出现peer依赖版本不兼容错误

云上老周

2026-4-21

我太懂这种peer依赖冲突的糟心感了——不想用--force或者--legacy-peer-deps这种可能埋下隐患的选项，又卡着没法安装需要的包，确实头疼！咱们先来理清问题根源，再一步步解决：

问题原因

你当前项目里的@nestjs/common是9.4.3版本，但要安装的@nestjs/microservices@10.1.3明确要求peer依赖必须是@nestjs/common@^10.0.0，版本不匹配直接触发了npm的依赖校验机制。而且你试过的--legacy-peer-deps只是跳过校验，实际v10版本的microservices大概率用到了v10 common里的新API或特性，v9的common根本不支持，所以编译失败是必然的。

解决方案：统一NestJS核心包版本到v10

你的package.json里已经有部分NestJS包升级到v10了（比如@nestjs/passport、@nestjs/typeorm），现在只需要把剩下的v9版本核心包同步升级，就能彻底解决冲突：

调整package.json里的依赖版本
把以下几个包的版本号改成v10兼容版本（建议和@nestjs/microservices保持同版本，比如10.1.3）：

"dependencies": {
  "@nestjs/cache-manager": "^2.1.0",
  "@nestjs/common": "^10.1.3", // 从^9.4.3修改
  "@nestjs/config": "^3.0.0",
  "@nestjs/core": "^10.1.3", // 从^9.0.0修改
  "@nestjs/passport": "^10.0.0",
  "@nestjs/platform-express": "^10.1.3", // 从^9.4.3修改
  "@nestjs/swagger": "^7.0.12",
  "@nestjs/typeorm": "^10.0.0",
  // 其他依赖保持不变
}

执行安装命令更新依赖
直接运行下面的命令，让npm统一安装匹配的版本：
```
npm install
```
或者更明确地指定要安装的包：
```
npm install @nestjs/common@^10.1.3 @nestjs/core@^10.1.3 @nestjs/platform-express@^10.1.3 @nestjs/microservices@^10.1.3
```
验证依赖一致性
安装完成后，可以运行下面的命令检查依赖树，确保所有@nestjs/common的版本都是统一的：
```
npm ls @nestjs/common
```