Ubuntu部署NestJS项目npm install报ERESOLVE依赖冲突问题

依赖冲突的本质是@nestjs/mongoose@8.0.1声明的peer依赖仅支持Mongoose 5.x版本（版本范围^5.11.15 || ^5.12.4），和项目中安装的mongoose@6.0.1（6.x大版本）存在跨大版本的不兼容。
本地Windows环境加--legacy-peer-deps/--force能正常安装、Ubuntu服务器上参数失效，和操作系统本身无关，基本是命令使用方式、环境版本、配置不一致导致的。

1. 从根源修复版本匹配问题（最稳定，不推荐长期靠强制参数绕过依赖校验） #

强制跳过peer依赖校验只是临时方案，跨大版本的依赖不兼容很容易导致线上运行时出现API不存在、逻辑异常等问题，优先调整版本匹配：

• 方案一：升级@nestjs/mongoose到适配Mongoose 6.x的版本。@nestjs/mongoose从9.0.0版本开始正式支持Mongoose 6.x，直接安装对应版本即可：

npm install @nestjs/mongoose@^9.0.0 mongoose@6.0.1

• 方案二：如果暂时无法升级NestJS相关依赖，就将Mongoose降级到5.x最新稳定版，匹配@nestjs/mongoose@8.0.1的依赖要求：

npm install mongoose@5.13.14
# Mongoose 5.13+版本已内置TS类型定义，不需要额外安装@types/mongoose，直接卸载即可避免额外的类型冲突
npm uninstall @types/mongoose

提示：Mongoose 6.x版本同样内置TS类型，你当前项目中安装的@types/mongoose@5.11.96本身就和Mongoose 6.x不匹配，即使安装成功也会报类型错误。

2. 临时绕过校验的问题排查（仅用于临时调试，不推荐生产环境长期使用） #

如果暂时无法调整依赖版本，按以下顺序排查Ubuntu环境参数失效的问题：

• 确认安装命令使用正确，不要用npm ci安装依赖：npm ci会严格按照lock文件内容安装，默认强制校验peer依赖，即使加--legacy-peer-deps参数也无法绕过冲突，必须使用npm install命令：

npm install --legacy-peer-deps

• 对齐两端npm版本：--legacy-peer-deps是npm 7.0.0之后才新增的参数，如果Ubuntu服务器上的npm版本低于7.x，加的参数会被直接忽略。先在本地Windows执行npm -v查看本地npm版本，再在服务器上安装同大版本的npm即可，比如本地是npm 8.x：

npm install -g npm@8

• 检查npm配置：查看项目根目录、服务器当前用户目录下的.npmrc文件，是否存在legacy-peer-deps=false、strict-peer-deps=true这类强制开启peer依赖严格校验的配置，如果有就删除对应配置，或者执行命令时显式覆盖配置：

npm install --legacy-peer-deps --strict-peer-deps=false

• 如果是Docker部署，先确认Dockerfile中的安装命令没有写错参数，不要直接拷贝Windows环境生成的package-lock.json到Linux镜像中使用（不同操作系统下部分依赖的可选依赖版本存在差异，可能触发额外冲突），可以先删除lock文件和node_modules目录，再重新执行带参数的安装命令。

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