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目录 - 重新执行依赖安装命令,再跑本地构建命令,直到本地构建无报错通过
- 如果本地构建阶段抛出依赖版本冲突提示,直接按报错信息升级/降级对应依赖到兼容版本即可
- 删除项目下的依赖锁文件(npm对应
- 本地构建跑通后,提交更新后的锁文件和依赖版本配置到代码仓库
- 回到Netlify项目后台,先清理构建缓存,再重新触发部署:操作路径为Deploys板块 -> 选择
Clear cache and deploy site执行重新部署
小提示:不要跳过本地构建验证步骤直接改Netlify配置,绝大多数依赖冲突在本地构建阶段就能复现,不用反复触发线上部署浪费调试时间。
内容的提问来源于stack exchange,提问作者mohammed shittu
相关产品推荐
相关产品推荐

