CircleCI 中ESLint检测失败却返回退出码0问题排查求助

最近碰到一个挺棘手的问题：在CircleCI流水线里执行ESLint命令时，明明检测出好几个错误，命令却返回了退出码0，导致流水线没被阻断；但在本地Windows和Unix系统上跑完全相同的命令，会正确返回退出码1——这才是我期望CircleCI该有的表现。

我执行的命令是：

yarn run eslint . --ext .json --ext .js --format junit -o reports/junit/eslint/js-lint-results.xml

而且CircleCI的测试摘要里也确实列出了这些失败的检测项，说明ESLint本身是检测到问题了，只是退出码的逻辑出了问题。

经过一番排查，总结了几个可能的原因和对应的解决办法：

1. 检查是否隐式启用了--quiet参数 #

有时候CI环境里，可能通过ESLint配置文件或者CircleCI的环境变量偷偷开启了--quiet模式。这个模式下，ESLint只会报告错误、忽略警告，但如果你的规则都设成了警告级别，那它就会返回退出码0。

• 解决步骤：
  • 先检查项目根目录的.eslintrc系列文件（比如.eslintrc.js、.eslintrc.json），看看有没有设置quiet: true
  • 再看看package.json里的eslintConfig字段，确认没开quiet模式
  • 最直接的办法是在CircleCI的命令里显式加--no-quiet参数，强制覆盖可能的隐式配置：

    yarn run eslint . --ext .json --ext .js --format junit -o reports/junit/eslint/js-lint-results.xml --no-quiet
    

2. 确认ESLint规则的严重级别 #

如果你的ESLint规则里，所有检测出的问题都被设为warn（警告）而不是error（错误）级别，那ESLint默认会返回退出码0。有可能本地和CircleCI的配置不一致，或者ESLint版本不同导致规则解析有差异。

• 解决步骤：
  • 对比本地和CircleCI的ESLint版本，两边都跑yarn list eslint看看版本号，确保一致
  • 打开ESLint配置文件，把那些需要阻断流水线的规则改成error级别，比如：

    "rules": {
      "no-unused-vars": "error",
      "prettier/prettier": "error"
    }
    

3. 换一种方式调用ESLint #

有时候通过yarn run执行命令，在CircleCI环境里可能会有特殊的处理，影响退出码。可以试试直接调用node_modules里的ESLint二进制文件：

./node_modules/.bin/eslint . --ext .json --ext .js --format junit -o reports/junit/eslint/js-lint-results.xml

4. 排查JUnit格式输出的影响 #

虽然用--format junit是为了让CircleCI能解析测试结果，但理论上不该影响退出码，不过可以先去掉格式参数测试一下：

yarn run eslint . --ext .json --ext .js

如果这时候退出码正常了，再逐步加回格式和输出参数，排查是哪一步出了问题。

小技巧：打印退出码方便排查 #

在CircleCI的作业里加一步，专门打印ESLint的退出码，能帮你更快定位问题：

yarn run eslint . --ext .json --ext .js --format junit -o reports/junit/eslint/js-lint-results.xml
echo "ESLint exit code: $?"

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