Next.js应用部署Vercel失败:npm next build报错退出码1求解决
Next.js 部署至 Vercel 失败的解决方案
- 统一 Node.js 版本:在项目根目录创建
.nvmrc文件,写入你本地开发使用的 Node.js 版本(例如v18.17.0),Vercel 会自动适配该版本,避免版本不兼容导致的构建失败。 - 本地预构建验证:先在本地执行
npm run build,确认项目能正常构建。如果本地构建也报错,优先解决本地的代码或依赖问题,再重新部署。 - 清理缓存与锁文件:删除
package-lock.json和node_modules,重新执行npm install生成新的依赖锁文件,部署时在 Vercel 后台触发「清除缓存并重新部署」。 - 调整构建命令:将 Vercel 的构建命令改为
npm run build -- --no-lint,跳过代码检查;或者在package.json的scripts中修改 build 命令为"build": "CI=false next build",确保 CI 模式完全关闭。 - 排查依赖冲突:执行
npm ls查看依赖树,确认 Next.js、react、react-dom 等核心依赖的版本是否匹配,避免版本冲突引发的构建错误。 - 核对环境变量:检查 Vercel 后台配置的环境变量,确保所有构建时需要的变量(尤其是
NEXT_PUBLIC_前缀的变量)和本地.env文件一致,无拼写或格式错误。 - 查看完整日志:在 Vercel 部署失败页面展开全部日志,定位具体的错误节点(如依赖安装失败、组件语法错误等),根据具体提示修复问题。
内容的提问来源于stack exchange,提问作者Flo
相关产品推荐
相关产品推荐

