You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Netlify部署报错Build script returned non-zero exit code:1如何解决?

Netlify部署报错Build was terminated: Build script returned non-zero exit code: 1处理方案

在Netlify部署项目时遇到上述报错,绝大多数触发原因是上游依赖冲突,按以下步骤排查修复即可:

  • 先对齐本地和Netlify侧的运行环境版本:确认Netlify配置的Node版本、包管理器(npm/yarn/pnpm)版本和本地开发环境完全一致,版本差是隐性依赖冲突的高发原因
  • 本地清理依赖后重新安装验证:
    • 删除项目下的依赖锁文件(npm对应package-lock.json、yarn对应yarn.lock、pnpm对应pnpm-lock.yaml)和node_modules目录
    • 重新执行依赖安装命令,再跑本地构建命令,直到本地构建无报错通过
    • 如果本地构建阶段抛出依赖版本冲突提示,直接按报错信息升级/降级对应依赖到兼容版本即可
  • 本地构建跑通后,提交更新后的锁文件和依赖版本配置到代码仓库
  • 回到Netlify项目后台,先清理构建缓存,再重新触发部署:操作路径为Deploys板块 -> 选择Clear cache and deploy site执行重新部署

小提示:不要跳过本地构建验证步骤直接改Netlify配置,绝大多数依赖冲突在本地构建阶段就能复现,不用反复触发线上部署浪费调试时间。

内容的提问来源于stack exchange,提问作者mohammed shittu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 11:00:59