Next.js项目部署至Vercel失败，遇EBADPLATFORM错误求助

问题原因 #

你本地是macOS（darwin）系统，生成的package-lock.json锁定了仅适配macOS的@next/swc-darwin-x64包，而Vercel构建环境为Linux，安装时因平台不兼容触发报错。

解决方案 #

方法1：生成适配Linux的lock文件 #

在本地终端执行以下命令，强制生成适配Linux x64平台的package-lock.json：

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

提交更新后的package-lock.json到Git仓库，重新部署即可。

方法2：修改Vercel构建命令 #

在Vercel项目的构建设置中，将安装命令改为：

npm install --no-package-lock

此举会让Vercel忽略本地lock文件，直接在Linux环境重新安装所有依赖，自动下载适配Linux的SWC包。

方法3：移除手动指定的SWC依赖 #

打开package.json，检查是否存在@next/swc-darwin-x64这类平台特定依赖，若有直接删除。重新执行npm install后提交修改，Next.js会根据运行环境自动安装对应SWC编译包，无需手动指定。

方法4：设置Vercel环境变量 #

在Vercel项目的环境变量中添加以下两个变量：

• NPM_CONFIG_PLATFORM=linux
• NPM_CONFIG_ARCH=x64
  npm在Vercel环境安装依赖时，会按照指定平台和架构下载适配包。

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