如何配置GitLab Pipeline在测试覆盖率低于阈值时失败

实现覆盖率不达标直接阻断Pipeline不需要自己写复杂脚本爬取覆盖率数值，用Jest原生能力配合GitLab CI的默认执行逻辑就能实现：

核心实现原理 #

GitLab Runner执行脚本时，只要任意一条命令返回非0的退出码，就会直接判定当前Job失败。Jest原生支持配置覆盖率阈值，只要覆盖率低于设定值，测试命令就会自动返回非0退出码，直接触发Pipeline失败，不需要额外写数值判断逻辑。 #

步骤1：配置Jest全局覆盖率阈值 #

在项目的Jest配置文件（jest.config.js/jest.config.ts，或package.json中的jest配置段）添加coverageThreshold规则，全局设置四个维度的覆盖率阈值均为80%：

// jest.config.js 示例
module.exports = {
  // 保留你项目里原有的其他Jest配置
  collectCoverage: true,
  coverageReporters: ["text", "lcov"], // 控制台输出文本格式报告+生成lcov文件
  coverageThreshold: {
    global: {
      branches: 80, // 分支覆盖率
      functions: 80, // 函数覆盖率
      lines: 80, // 行覆盖率
      statements: 80 // 语句覆盖率
    }
  }
}

配置完成后可以本地先执行npm test -- --coverage --watchAll=false验证：如果覆盖率不达标，命令行直接报错，进程退出码不为0，符合CI拦截的触发条件。 #

步骤2：调整GitLab Pipeline配置 #

你原有的配置里coverage字段的作用是用正则提取控制台输出的全量覆盖率数值，用来在GitLab的流水线、合并请求页面展示覆盖率指标，本身不做阈值判断。只需要微调脚本稳定性即可，完整可用配置如下：

test:
  stage: test
  image: node:16.13.1
  before_script:
    - npm ci # 替换npm i，CI环境用npm ci严格按照lock文件安装依赖，稳定性更高
    - node -v
    - npm -v
  script:
    - echo "running unit test with coverage check"
    - npm test -- --coverage --watchAll=false
  # 正则用于提取覆盖率数值在GitLab UI展示，保留原有配置即可
  coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'

注意事项 #

不推荐在CI侧写Shell正则爬取覆盖率数值做判断：Jest控制台输出格式可能随版本变化，正则匹配容易出现漏判、错判；Jest原生阈值配置还支持按目录、按单个文件设置差异化阈值，灵活度和可靠性都远高于自定义脚本。

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