理解 EBADPLATFORM 部署错误
当您尝试将 next.js 应用部署到 vercel 时，如果遇到类似 npm err! code ebadplatform 的错误，并且错误信息中明确指出平台不兼容，例如 wanted {"os":"darwin","arch":"x64"} (current: {"os":"linux","arch":"x64"})，这表明您的项目依赖中包含了特定于 macos (darwin) 平台的包，而 vercel 的构建环境是基于 linux 的。
此问题通常与 Next.js 内部使用的 SWC (Speedy Web Compiler) 相关。SWC 是一种高性能的 JavaScript/TypeScript 编译器，为了最大化性能，它会提供针对不同操作系统和 CPU 架构的预编译二进制文件。如果您在 macOS 上开发，@next/swc-darwin-x64 可能会被安装。然而，当部署到 Vercel（Linux x64 环境）时，如果这个 macOS 版本的 SWC 包被包含在依赖中，就会导致构建失败。
典型的错误日志如下：
npm ERR! code EBADPLATFORM
npm ERR! notsup Unsupported platform for @next/swc-darwin-x64: wanted {"os":"darwin","arch":"x64"} (current: {"os":"linux","arch":"x64"})
npm ERR! notsup Valid OS: darwin
npm ERR! notsup Valid Arch: x64
npm ERR! notsup Actual OS: linux
npm ERR! notsup Actual Arch: x64
npm ERR! A complete log of this run can be found in:
npm ERR! /vercel/.npm/_logs/2023-05-30T18_43_56_771Z-debug-0.log
Error: Command "npm install" exited with 1
BUILD_UTILS_SPAWN_1: Command "npm install" exited with 1解决方案步骤
解决此问题的核心在于确保您的项目依赖中只包含适用于 Vercel Linux 环境的 SWC 包。
步骤一：确认并移除错误的 SWC 依赖
首先，您需要从项目中移除不适用于 Linux 环境的 SWC 包，即 @next/swc-darwin-x64。即使您没有在 package.json 中直接声明这个依赖，它也可能作为 Next.js 或其他相关包的传递性依赖被安装。
在您的项目根目录下执行以下命令：
npm uninstall @next/swc-darwin-x64
此命令将从您的 node_modules 目录中删除该包，并更新 package.json 和 package-lock.json（如果它被直接列为依赖）。
步骤二：安装适用于 Vercel 环境的 SWC 依赖
接下来，您需要安装适用于 Vercel Linux x64 环境的 SWC 包：@next/swc-linux-x64。
执行以下命令：
npm install @next/swc-linux-x64
此操作将确保您的项目在 Vercel 构建时能够找到并使用正确的 SWC 编译器。通常，Next.js 会在 npm install 过程中根据当前平台自动选择并安装正确的 SWC 包。但如果之前安装了错误的平台包，手动指定安装是必要的。
步骤三：重新部署应用
完成上述步骤后，请将您的更改推送到 Git 仓库（如果您的 Vercel 项目是与 Git 集成的），然后触发一次新的 Vercel 部署。Vercel 将会拉取最新的代码并重新执行构建过程，此时应该能够成功安装依赖并完成部署。
注意事项与高级排查
- 传递性依赖问题: 如果您在 package.json 中没有直接看到 @next/swc-darwin-x64，但仍遇到此问题，那么它很可能是一个传递性依赖。在这种情况下，上述的 npm uninstall 和 npm install 步骤通常也能解决问题，因为 npm install 会尝试解决依赖树并安装正确的平台包。
- Next.js 版本: 确保您的 Next.js 版本是最新的或至少是一个稳定版本。有时，旧版本的 Next.js 在处理 SWC 依赖方面可能存在一些问题。升级 Next.js 到最新版本有助于避免这类平台依赖问题。
- 清理 node_modules 和 package-lock.json: 虽然在某些情况下，删除 node_modules 目录和 package-lock.json 文件并重新运行 npm install 可能有助于解决依赖问题，但对于本教程中描述的平台特定 SWC 依赖问题，直接卸载错误包并安装正确包是更精确和有效的解决方案。
- Vercel 构建日志: 部署失败时，仔细检查 Vercel 的构建日志至关重要。日志会提供详细的错误信息，帮助您准确定位问题。
总结
EBADPLATFORM 错误在 Next.js 应用部署到 Vercel 时，通常源于 SWC 编译器包的平台不兼容性。通过明确地移除为 macOS 构建的 @next/swc-darwin-x64 包，并安装适用于 Vercel Linux 环境的 @next/swc-linux-x64 包，可以有效解决此问题。遵循本教程的步骤，您将能够确保 Next.js 应用在 Vercel 平台上顺利完成构建和部署。
