Vue应用部署到Netlify时构建终止返回非零退出码1如何解决

常见原因及对应修复方案 #

1. Node版本与依赖不兼容 #

你项目package.json中指定的Node版本为14.15.4，而当前使用的node-sass@4.12.0最高仅支持Node 14版本，若Netlify默认使用更高版本Node运行构建，会直接触发sass编译失败。
修复方式二选一即可：

• 锁定Netlify构建Node版本：在站点设置>构建和部署>环境变量中新增变量NODE_VERSION，值填写14.15.4，重新触发构建
• 替换node-sass为无环境依赖版本：本地执行npm uninstall node-sass && npm install sass --save-dev，提交修改后的package.json和package-lock.json后重新部署

2. ESLint校验错误中断构建 #

vue-cli生产构建默认会执行ESLint校验，本地开发未修复的lint报错会在部署时直接终止构建流程。
修复方式：

• 本地先执行npm run lint，修复所有代码校验错误后再提交部署
• 若需要临时跳过校验，可将package.json中的build命令修改为vue-cli-service build --no-lint

3. 依赖缓存损坏 #

Netlify缓存的依赖文件损坏会导致依赖安装不完整，触发构建异常。
修复方式：
在Netlify部署页面点击「触发部署」下拉按钮，选择「清除缓存并部署」，重新执行完整构建流程。

4. 构建设置配置错误 #

需确认Netlify站点的构建设置和项目匹配：

• 构建命令：npm run build
• 发布目录：dist

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