在使用 next.js 开发应用并将其部署到 vercel 时，开发者可能会遇到因平台依赖不兼容导致的构建失败。其中一个常见问题是与 swc（speedy web compiler）相关的错误，具体表现为尝试在 linux 环境（vercel 部署环境通常基于 linux）中运行 macos 平台专用的 swc 包。
当您在 Vercel 部署日志中看到类似以下错误信息时，即表明遇到了此问题：
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
Error: Command "npm install" exited with 1这段错误信息清晰地指出，@next/swc-darwin-x64 包被设计用于 Darwin (macOS) 操作系统和 x64 架构，但当前的部署环境是 Linux 操作系统和 x64 架构，导致平台不匹配。
解决此问题的核心在于将项目中错误的平台特定 SWC 包替换为适用于 Linux 环境的正确包。请按照以下步骤操作：
首先，您需要从项目的依赖中移除 macOS 专用的 @next/swc-darwin-x64 包。即使您在 package.json 中没有直接看到这个依赖，它也可能作为其他依赖的子依赖被引入。执行以下命令来卸载它：
npm uninstall @next/swc-darwin-x64
此命令会尝试从 node_modules 目录和 package.json 文件中移除该包及其相关条目。
移除错误的包后，您需要安装 Vercel Linux 部署环境兼容的 SWC 包，即 @next/swc-linux-x64。执行以下命令进行安装：
npm install @next/swc-linux-x64
这将把适用于 Linux 平台的 SWC 包添加到您的项目依赖中。
完成上述依赖包的替换后，务必将这些更改提交到您的版本控制系统（例如 Git），然后触发 Vercel 的重新部署。Vercel 会拉取最新的代码，并使用正确的依赖进行构建。
git add . git commit -m "Fix: Replace @next/swc-darwin-x64 with @next/swc-linux-x64 for Vercel deployment" git push
重新部署后，您的 Next.js 应用应该能够顺利构建并上线。
CA.LA
第一款时尚产品在线设计平台，服装设计系统
86
查看详情
如果您的 package.json 中没有直接列出 @next/swc-darwin-x64，但仍然遇到此问题，这通常意味着它作为 Next.js 或其他相关包的间接（或传递性）依赖被引入。在这种情况下，您可以尝试以下方法：
检查 package-lock.json： 仔细检查 package-lock.json 文件，搜索 @next/swc-darwin-x64。它会显示哪个父依赖引入了它。
更新 Next.js 版本： 有时，旧版本的 Next.js 可能会在某些环境下错误地引入平台特定的 SWC 包。尝试将 Next.js 更新到最新稳定版本，通常可以解决这类问题。
清理 node_modules 和 package-lock.json： 在某些复杂情况下，手动删除 node_modules 目录和 package-lock.json 文件，然后重新运行 npm install，可以强制 npm 重新解析所有依赖并生成新的锁定文件。但请注意，此操作可能导致其他依赖版本发生变化，需谨慎。
rm -rf node_modules rm package-lock.json npm install
Vercel 的构建环境通常是基于 Linux 的，这意味着所有部署到 Vercel 的应用都必须确保其所有依赖项都与 Linux 平台兼容。在开发过程中，如果您的本地开发环境是 macOS 或 Windows，请务必留意那些可能引入平台特定二进制文件的依赖包。
对于 Next.js 和 Vercel 的部署问题，查阅官方文档和社区讨论是非常有益的。例如，Next.js 的 GitHub Issues 中就有很多关于 SWC 平台兼容性的讨论，它们能提供更深入的背景信息和解决方案。
平台兼容性是部署现代 Web 应用时需要特别关注的一个方面。当 Next.js 应用在 Vercel 部署时遇到 @next/swc-darwin-x64 平台不兼容错误，通过移除错误的 macOS 专用 SWC 包并安装正确的 Linux 兼容包 @next/swc-linux-x64，可以有效解决此问题。此外，理解间接依赖、定期更新核心框架以及熟悉部署环境的特性，将有助于您避免类似的部署障碍，确保项目顺利上线。
以上就是Next.js 应用在 Vercel 部署时解决 SWC 平台不兼容错误的详细内容，更多请关注其它相关文章！
# 不兼容
# seo怎么读韩语
# 做网站seo优化
# ecshop seo标题修改
# 台州关键词网站推广公司
# 网站推广的方法是什么
# 网站怎样优化推荐产品呢
# 多阶段活动营销推广方案
# 企业如何做网络营销推广
# seo网易考拉
# 杭州建设厅网站
# 执行情况
# 错误信息
# 您需要
# 您在
# 适用于
# linux
# 移除
# 用在
# 您的
# 常见问
# win
# macos
# mac
# 操作系统
# github
# windows
# node
# json
# git
# js
相关栏目：
【
Google疑问12 】
【
Facebook疑问10 】
【
优化推广96088 】
【
技术知识133117 】
【
IDC资讯59369 】
【
网络运营7196 】
【
IT资讯61894 】
相关推荐：
《淘宝联盟》推广自己的店铺方法
Golang如何实现HTTP请求重试机制_Golang HTTP请求错误处理策略
12306售票时间最新规定 | 网上订票和车站窗口时间一样吗
如何在解析前预检查XML文件的完整性？ 比如检查文件大小或特定结束标签
如何快速去除厨房重油污？ 2025年最好用的厨房清洁剂推荐
嘀嗒顺风车如何开具电子发票
Python实战：高效处理实时数据流中的最小/最大值
ExcelSCAN与LAMBDA如何创建自定义移动平均函数_SCAN实现任意窗口期移动平均计算
如何在CSS中清除浮动解决背景颜色不包裹内容问题_clear after技巧
曝《丝之歌》DLC有望开发！开发商还有神秘新企划
QQ阅读小说搜索入口地址_QQ阅读小说搜索入口地址搜索在线阅读
顺丰速运官网查询入口 顺丰物流查询官网入口链接
iQOO手机信号差网络不稳定怎么办 信号问题原因排查与增强设置【攻略】
mysql如何配置从库只读_mysql从库只读设置方法
Flexbox布局实践：实现底部页脚与顶部粘性导航条的完美结合
英雄联盟争者留名活动介绍
mysql离线安装后如何启动_mysql离线安装完成后启动服务的方法
Highcharts雷达图径向轴数值标签实现教程
mysql归档数据怎么导出为csv_mysql归档数据导出为csv文件的方法
《虎扑》取消评分记录方法
《梦想世界：长风问剑录》药师一图流分享
以下哪一项是古代兵书三十六计中的计谋
修复UI元素交互障碍：从“开始”按钮到信息框的平滑过渡实现
铁路12306买票怎么选双人铺 铁路12306卧铺分配规则说明
包子漫画在线观看入口 包子漫画网正版全集链接
Safari浏览器自动填表功能失效怎么办 Safari表单管理修复
百度识图图像分析 百度识图识别平台
123平台官方登录入口 123邮箱网页端在线沟通工具
如何使用 Optional 类型并满足 Pylint 的类型检查
《oppo商城》维修服务位置
12306夜间购票失败？ | 查看官方公布的暂停服务公告与应对方案
Flexbox布局：实现粘性导航与底部页脚的完美结合
C++ switch case字符串_C++如何实现字符串switch匹配
抖音号升级企业号怎么改名字？升级企业号有哪些好处？
Sublime怎么快速复制文件路径_Sublime右键菜单增强技巧
利用Flexbox实现图片元素的二维布局：2x2网格排列指南
sublime如何配置PHP开发环境_在sublime中运行与调试PHP代码
Teambition网盘如何共享文件
太平年在哪个平台播出
电脑的“恢复环境(WinRE)”找不到怎么办_Windows系统恢复环境重建【高级修复】
阿里旺旺电脑网页版入口 阿里旺旺电脑版网页登录入口
C#解析来自网络的XML流数据 实时错误处理与重试机制
键盘声音异常怎么回事_键盘异响怎么处理
快手极速版在线体验区 快手极速版网页体验入口
在PHP环境中正确加载HTML资源：CSS样式与图片路径指南
Scipy Sparse CSR 矩阵非零元素行级遍历的最佳实践
飞飞漫画漫画阅读官网_飞飞漫画漫画阅读官网进入阅读
冬季去哪个城市旅游更有可能观测到极光
晨报|开发商暗示《空洞骑士：丝之歌》DLC开发中 《合金装备4》有望重制
微信客户端如何找回密码_微信客户端忘记密码找回方法
2025-10-06
运城市盐湖区信雨科技有限公司是一家深耕海外推广领域十年的专业服务商，作为谷歌推广与Facebook广告全球合作伙伴，聚焦外贸企业出海痛点，以数字化营销为核心，提供一站式海外营销解决方案。公司凭借十年行业沉淀与平台官方资源加持，打破传统外贸获客壁垒，助力企业高效开拓全球市场，成为中小企业出海的可靠合作伙伴。