Gitlab-CI构建React应用失败，本地及部署服务器运行正常

问题根因 #

你的流水线失败确实是ESLint代码校验规则触发的：create-react-app自带的react-scripts在检测到CI环境变量被自动设置为true时，会默认将所有ESLint告警提升为错误，直接让构建进程返回非0退出码，导致流水线判定失败。你本地和部署服务器运行时没有自动开启这个严格校验模式，所以不会触发报错，构建产物本身也可以正常使用。

可选解决方案 #

方案1：修复代码中的ESLint问题（推荐） #

按照报错提示逐一修改代码即可彻底解决：

• 把所有==替换为===、!=替换为!==，满足eqeqeq规则要求
• 删除所有声明后未使用的变量，满足no-unused-vars规则要求
• 修正style属性为标准对象格式，满足react/style-prop-object规则要求

方案2：关闭ESLint校验阻止构建失败 #

如果不需要在流水线阶段做代码质量校验，可以通过配置直接忽略ESLint错误：

1. 在项目根目录创建.env.production文件，添加如下配置：

ESLINT_NO_DEV_ERRORS=true
DISABLE_ESLINT_PLUGIN=true

2. 也可以直接修改package.json中的build命令，临时关闭校验：

"scripts": {
  "build": "DISABLE_ESLINT_PLUGIN=true react-scripts build"
}

如果需要兼容Windows运行环境，可以安装cross-env包后修改为cross-env DISABLE_ESLINT_PLUGIN=true react-scripts build

方案3：拆分校验环节单独处理 #

如果希望保留校验规则但不阻断正常构建，可以把lint校验从build步骤拆分出来，单独作为非阻断的流水线阶段：

• 修改gitlab-ci.yml，新增lint阶段并设置allow_failure: true，build阶段保留关闭ESLint的配置
• 后续可通过Gitlab代码质量扫描功能单独统计lint问题，不会影响正常构建部署流程

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