Vercel部署Next.js项目遇npm依赖树解析错误求助

问题背景 #

部署Next.js项目到Vercel时，npm安装依赖阶段报错，核心冲突是：

• 项目依赖的@sanity/client版本为3.4.1
• next-sanity-image@3.2.1的peer依赖要求@sanity/client@^2.11.0，版本不匹配导致依赖树无法解析

完整报错日志：

[20:19:35.061] Cloning github.com/oneboyfromife/macho-store (Branch: main, Commit: 48072bd)
[20:19:35.209] Previous build cache not available
[20:19:36.082] Cloning completed: 1.020s
[20:19:36.317] Running "vercel build"
[20:19:36.972] Vercel CLI 28.10.0
[20:19:37.389] Installing dependencies...
[20:19:39.176] npm ERR! code ERESOLVE
[20:19:39.179] npm ERR! ERESOLVE 无法解析依赖树
[20:19:39.180] npm ERR! 
[20:19:39.180] npm ERR! While resolving: mocha-store@0.1.0
[20:19:39.180] npm ERR! Found: @sanity/client@3.4.1
[20:19:39.180] npm ERR! node_modules/@sanity/client
[20:19:39.180] npm ERR!   @sanity/client@"^3.2.0" from the root project
[20:19:39.181] npm ERR! 
[20:19:39.181] npm ERR! 无法解析依赖：
[20:19:39.181] npm ERR! peer @sanity/client@"^2.11.0" from next-sanity-image@3.2.1
[20:19:39.181] npm ERR! node_modules/next-sanity-image
[20:19:39.181] npm ERR!   next-sanity-image@"^3.2.1" from the root project
[20:19:39.182] npm ERR! 请修复上游依赖冲突，或使用--force、--legacy-peer-deps参数重试
[20:19:39.182] npm ERR! 以接受不正确（可能存在问题）的依赖解析结果。
[20:19:39.182] npm ERR! 
[20:19:39.182] npm ERR! 完整报告请查看/vercel/.npm/eresolve-report.txt
[20:19:39.183] 
[20:19:39.183] npm ERR! 本次运行的完整日志可在以下路径查看：
[20:19:39.183] npm ERR!     /vercel/.npm/_logs/2022-12-30T19_19_37_735Z-debug-0.log
[20:19:39.205] Error: Command "npm install" exited with 1

解决方法 #

方法1：升级next-sanity-image到兼容@sanity/client v3的版本 #

next-sanity-image的新版本已支持@sanity/client v3，直接更新依赖版本：

• 修改项目根目录的package.json，将next-sanity-image的版本改为^5.0.0（或最新兼容版本）
• 本地运行npm install验证依赖安装正常
• 提交修改到GitHub，重新触发Vercel部署

方法2：在Vercel中修改安装命令，跳过peer依赖检查 #

如果确认两个版本实际兼容（或需临时解决），可在Vercel中配置安装命令：

• 进入Vercel项目的Settings → Build & Development Settings
• 在Install Command中，将默认的npm install改为：
  • npm install --legacy-peer-deps（推荐，采用npm v4-v6的peer依赖解析逻辑）
  • 或npm install --force（强制忽略冲突，可能引入潜在问题）
• 保存设置后重新触发部署

方法3：降级@sanity/client到v2版本 #

如果不需要@sanity/client v3的特性，可降级到符合peer依赖要求的版本：

• 修改package.json中@sanity/client的版本为^2.23.2（或其他v2稳定版）
• 本地运行npm install验证
• 提交修改后重新部署

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