Vercel部署React+Vite项目时遇npm ERR! code EBADPLATFORM错误求助

部署时执行npm install报错，核心原因是本地Mac ARM架构（darwin-arm64）生成的依赖锁定文件里，被锁定了仅支持该平台的@esbuild/darwin-arm64@0.19.5包，但Vercel构建环境是linux-x64，导致依赖不兼容。

解决方法 #

方法一：生成适配Vercel环境的依赖锁定文件 #

1. 删除项目根目录的package-lock.json和node_modules文件夹
2. 本地执行命令，生成适配linux-x64平台的lock文件：

   npm install --package-lock-only --platform=linux --arch=x64
   

3. 把新生成的package-lock.json提交到GitHub，重新触发部署

方法二：用npm overrides强制统一兼容版本 #

在项目的package.json中添加overrides字段，确保esbuild的平台依赖覆盖为兼容Vercel的版本：

"overrides": {
  "@esbuild/darwin-arm64": "0.19.5",
  "@esbuild/linux-x64": "0.19.5"
}

提交修改后的package.json，重新部署即可。

方法三：直接修改Vercel的安装命令 #

进入Vercel项目的构建设置页面，将默认的安装命令从npm install改成：

npm install --platform=linux --arch=x64

该命令会强制npm在安装时适配linux-x64平台，忽略本地环境的依赖锁定。

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