Heroku部署报错：mongoose与mongoose-unique-validator依赖解析失败

从部署日志可以直接定位到核心问题：npm 8.x默认开启严格peer依赖校验，你项目里的两个包版本不满足兼容要求：

• 项目根目录直接依赖的是mongoose@^6.4.4（6.x大版本）
• 项目依赖的mongoose-unique-validator@2.0.3声明的peer依赖要求是mongoose@^5.2.1（仅支持5.x大版本），跨大版本不兼容，直接导致依赖树解析失败。
  另外你的package.json里没有配置engines字段指定Node和npm版本，Heroku默认拉取了Node 16.16.0 + npm 8.11.0的环境，这也是很多人本地安装正常、线上部署报错的常见诱因——本地如果用的是npm 6及以下版本，默认不会强制阻断peer依赖冲突的安装流程。

方案1：升级mongoose-unique-validator到兼容mongoose 6.x的版本（最稳妥，无兼容隐患） #

mongoose-unique-validator从3.0.0版本开始正式支持mongoose 6.x，直接升级对应依赖即可：

1. 在本地项目目录执行以下命令，替换不兼容的旧版本：

npm uninstall mongoose-unique-validator
npm install mongoose-unique-validator@^3.1.0

2. 本地启动项目验证所有涉及mongoose、唯一校验的逻辑正常运行后，把更新后的package.json和package-lock.json提交到Heroku仓库重新部署即可。

方案2：降级mongoose到5.x大版本匹配现有校验包 #

如果因为业务代码原因暂时不能升级mongoose-unique-validator，可以把mongoose降级到5.x版本满足依赖要求：

npm uninstall mongoose
npm install mongoose@^5.13.15

注意mongoose 5.x和6.x存在部分API差异，降级后要逐一检查业务代码里的mongoose调用，避免上线后出现运行时错误，验证无误后提交配置文件重新部署。

方案3：临时跳过peer依赖校验（快速上线用，不推荐长期使用） #

如果暂时没有时间调整版本兼容，只想先把服务部署跑通，可以通过配置绕开npm的严格依赖校验：

• 方式一：给Heroku配置环境变量，让npm安装依赖时默认带上--legacy-peer-deps参数，直接在本地项目目录执行Heroku命令即可：

heroku config:set NPM_CONFIG_LEGACY_PEER_DEPS=true

• 方式二：在package.json里添加engines字段，固定npm版本为6.x（npm 6默认不会强制阻断peer依赖冲突的安装），同时固定Node版本避免后续环境不一致问题：

"engines": {
  "node": "16.x",
  "npm": "6.x"
}

注意：该方案只是跳过了安装阶段的校验，跨大版本不兼容的包共同运行可能出现隐式逻辑错误，上线后要尽快调整到版本兼容的状态。

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