Vercel部署作品集网站报错求助：本地运行正常但部署失败

核心排查与修复步骤 #

• 校验Build命令
  确认package.json中scripts字段的build命令是否匹配项目类型：
  • React项目应为 "build": "react-scripts build"
  • Next.js项目应为 "build": "next build"
    Vercel默认读取该命令，命令错误会直接终止构建。
• 调整依赖分类
  检查package.json的依赖列表，将react、react-dom这类生产必需的包从devDependencies移至dependencies。Vercel生产构建时会跳过devDependencies安装，缺失核心依赖会引发报错。
• 配置Vercel构建参数
  进入Vercel项目的「Settings」→「Build & Development Settings」：
  • 手动指定Build Command，确保与package.json中的命令一致
  • 确认Output Directory正确（React为build，Next.js为.next）
• 清除构建缓存
  在Vercel构建日志页面点击「Redeploy」，勾选「Clear build cache」后重新部署，避免缓存导致的异常。
• 统一Node.js版本
  在package.json中添加"engines": { "node": ">=16.x" }（替换为你本地使用的版本），强制Vercel使用匹配的Node环境，避免版本差异引发兼容问题。

针对你的场景补充 #

结合错误与package.json信息，优先排查：

1. build命令是否存在且无拼写错误
2. 是否有生产必需的依赖被误放在devDependencies中
3. 若存在vercel.json配置文件，检查路由规则、输出目录等配置是否冲突

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