如何解决Vercel部署时npm的ERESOLVE peer依赖冲突问题

你的错误核心是**@mantine/rte@5.10.5要求的peer依赖为@mantine/core@5.10.5**，但项目实际安装的是**@mantine/core@6.0.21**，版本不匹配导致npm解析失败。本地运行正常是因为npm版本或默认配置对peer依赖冲突的容忍度更高，而Vercel构建环境采用更严格的解析策略。

方案1：统一Mantine包版本（推荐） #

Mantine生态的所有包版本需保持一致，将@mantine/rte升级到和@mantine/core、@mantine/hooks匹配的6.x版本：

1. 修改package.json中的依赖项：

"@mantine/rte": "^6.0.0",

2. 本地执行 npm install 更新依赖
3. 运行 npm run build 验证本地构建正常
4. 重新部署到Vercel

方案2：强制忽略peer依赖冲突（应急用） #

如果暂时无法升级@mantine/rte，可让npm跳过peer依赖检查：

方式A：修改package.json添加配置 #

在package.json根节点添加：

"npmConfig": {
  "legacy-peer-deps": true
}

方式B：修改Vercel构建命令 #

在Vercel项目的「设置」→「构建与开发设置」中，将构建命令改为：

npm install --legacy-peer-deps && npm run build

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