Next.js部署Vercel时遇ERR_PNPM_OUTDATED_LOCKFILE错误的修复方法

错误含义 #

这个错误说明你的pnpm-lock.yaml锁文件和package.json中的依赖配置不一致。Vercel默认采用frozen-lockfile模式执行依赖安装——该模式会强制要求锁文件与package.json的依赖声明完全匹配，避免构建过程中出现意外的依赖版本更新。当你本地修改了package.json里的依赖版本、新增或删除了依赖，却没有同步更新锁文件时，就会触发这个报错。

修复方法 #

方法一：同步本地锁文件（推荐） #

1. 在项目根目录执行命令，重新生成匹配当前package.json的锁文件：

   pnpm install
   

2. 将更新后的pnpm-lock.yaml和修改过的package.json一同提交到Git仓库：

   git add package.json pnpm-lock.yaml
   git commit -m "Sync pnpm lockfile with package.json"
   git push
   

3. 触发Vercel重新构建：推送上述提交后，Vercel会自动启动新的构建任务；也可以直接在Vercel控制台找到对应项目，手动点击「重新部署」。

方法二：禁用锁文件冻结模式（不推荐） #

如果你临时需要跳过锁文件校验，可以在Vercel的项目构建设置中，将默认的安装命令从pnpm install修改为：

pnpm install --no-frozen-lockfile

⚠️ 注意：这种方法会让Vercel忽略锁文件与package.json的差异，可能导致每次构建安装的依赖版本不一致，降低构建的稳定性和可重复性，仅建议作为临时解决方案。

内容的提问来源于stack exchange，提问作者Coder Gautam YT