Vercel部署Next.js项目时版本检测失败及SWC相关问题求助

1. 修复SWC跨平台依赖问题 #

这是触发后续版本检测失败的核心原因——手动安装的@next/swc-darwin-x64仅适配Mac平台，而Vercel生产环境为Linux，会导致依赖安装失败，进而使Next.js无法被正确识别：

• 删除本地的package-lock.json、node_modules和.next文件夹，彻底清理残留构建文件
• 移除package.json中手动添加的@next/swc-darwin-x64依赖（Next.js会自动根据部署平台匹配对应SWC包，无需手动指定）
• 重新执行npm install（或yarn install/pnpm install），让包管理器自动生成适配多平台的锁文件

2. 解决Next.js版本检测失败问题 #

检查Vercel项目框架配置 #

• 登录Vercel控制台，进入目标项目的Settings > Build & Development Settings
• 确认Framework Preset选择为Next.js，而非Other（选择Other会让Vercel跳过Next.js自动检测逻辑）

确保部署命令与包管理器配置正确 #

• 检查package.json的scripts字段，确认build命令为next build：

"scripts": {
  "dev": "next dev",
  "build": "next build",
  "start": "next start"
}

• 若使用Vercel CLI部署，直接执行vercel deploy --prod跳过预览环境迁移环节；若项目未关联Vercel，先执行vercel link重新绑定后再部署

强制指定Vercel的安装与构建命令 #

在项目根目录创建vercel.json文件，明确指定包管理器与构建命令，避免Vercel自动推断出错：

{
  "installCommand": "npm install",
  "buildCommand": "npm run build"
}

3. 排查构建日志 #

若问题仍存在，查看Vercel生产环境的Build Logs，重点检查Installing dependencies阶段是否有报错（依赖安装失败会直接导致Next.js未被正确安装，进而触发版本检测错误）

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