Next.js项目本地`next build`正常但部署至Vercel时仅提示`Error: Command "npm run build" exited with 1`失败

我之前完全遇到过和你一样的情况——本地npm run dev和npm run build都完美运行，一到Vercel上就只扔个Error: Command 'npm run build' exited with 1，连个具体错误提示都没有，折腾了好半天。结合你的构建日志和我踩过的坑，给你几个针对性的排查方向：

1. 强制开启Vercel的详细构建日志 #

Vercel默认会截断部分日志，导致看不到真正的错误原因。你可以这么做：

• 打开Vercel项目的Build & Development Settings，添加一个环境变量：
  • 变量名：NEXT_PRIVATE_DEBUG
  • 变量值：true
• 或者修改package.json里的build命令：

  "scripts": {
    "build": "NEXT_PRIVATE_DEBUG=true next build"
  }
  

重新部署后，就能看到完整的错误追踪信息了——比如某个组件的隐藏类型错误、资源路径问题，这是最快找到根源的方法。

2. 替换node-sass为sass（dart-sass） #

从你的日志能看到，你在用node-sass@4.14.1，这个包已经被官方弃用了，和Vercel上的Node.js版本（日志里的linux-x64-83对应Node.js 14.x）可能存在隐性兼容性问题。换成维护中的sass包会更稳定：

• 卸载node-sass：npm uninstall node-sass
• 安装sass：npm install sass --save
  然后把项目里所有引用node-sass的地方改成sass，再重新部署试试。

3. 确保本地和Vercel的Node.js版本一致 #

本地的Node.js版本如果和Vercel默认的不一样，很可能导致依赖安装或构建时出现隐性错误。你可以：

• 在项目根目录创建.nvmrc文件，写入你本地使用的Node.js版本，比如14.17.0
• 或者在Vercel的Build & Development Settings里手动指定Node.js版本
  两边环境一致了，就能避免很多版本差异带来的问题。

4. 检查环境变量配置 #

本地的.env.local里可能有一些你没注意到的环境变量，而Vercel上没有配置，导致构建时某些组件或依赖无法正常工作：

• 把本地.env.local里的所有必要环境变量（敏感信息除外）都添加到Vercel的环境变量设置中
• 仔细核对变量名和值完全一致，哪怕一个拼写错误都可能导致构建静默失败

5. 清理Vercel的构建缓存 #

有时候Vercel的缓存会残留旧的依赖或构建文件，导致莫名其妙的错误。你可以：

• 进入Vercel的构建历史页面，点击Redeploy
• 取消勾选Use existing build cache选项，强制重新安装依赖并构建
  这种干净的构建往往能解决一些缓存相关的奇怪问题。

按照这些步骤一步步排查，肯定能找到具体的错误原因。我当时就是开启详细日志后，发现是某个组件里隐藏的TypeScript错误，本地开发时没触发，构建时才暴露出来。

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