GitLab代码覆盖率徽章显示Unknown问题求助

咱们一步步来排查和解决这个问题，我遇到过不少类似的情况，通常是这几个环节出了问题：

1. 确认Job日志输出是否匹配你的正则表达式 #

你的正则是^Statements\s*:\s*([^%]+)，这个要求行首必须是"Statements"，后面跟着任意空格、冒号、任意空格，再是不含%的覆盖率数值。

先去CI Job的日志里找对应行，排查这几个点：

• 行首有没有多余空格？比如输出是 Statements : 92.5%，那^会匹配失败，得把正则改成^\s*Statements\s*:\s*([^%]+)（加上开头的任意空格匹配）
• 有没有大小写不一致？比如工具输出的是statements小写，而你的正则是大写的Statements，这时候要调整大小写或者加不敏感标记（比如(?i)^Statements...）
• 有没有前缀字符？比如[coverage] Statements : 89%，那^就匹配不到，得去掉^或者调整正则包含前缀

2. 确保覆盖率数据来自正确的Job #

GitLab需要明确知道哪个Job的输出用来提取覆盖率：

• 如果你的.gitlab-ci.yml里是给特定Job加的coverage字段，要确认这个Job确实成功运行，且是它输出了覆盖率数据
• 如果是在项目CI/CD > Settings > General > Test coverage parsing里设置的正则，要确保指定的Job（如果有选择）是正确的；没指定的话，所有Job都会被检查，但只有匹配的那个会被采用

3. 确认Job处于成功状态 #

GitLab只会从**成功（passed）**的Job里提取覆盖率数据——哪怕日志里有覆盖率输出，只要Job失败了，数据就不会被统计。先检查Job的状态是不是passed，有没有报错导致Job终止。

4. 重新运行Job，确保配置生效 #

修改.gitlab-ci.yml或者CI/CD设置后，旧的Job数据不会重新计算覆盖率。手动触发一次Pipeline，让Job重新运行，再看徽章是否更新。

5. 检查正则的捕获组是否正确 #

你的正则里([^%]+)是捕获覆盖率数值的组，要确保它能抓到纯数值（包括小数点）。比如输出是Statements : 95.23%，这个组会抓到95.23，是正确的；如果输出是Statements : 95% (total)，[^%]+会抓到95，也没问题。

6. 确认徽章配置正确 #

去项目的Settings > General > Badges里检查：

• 确保选择的是"Test coverage"类型的徽章
• 徽章的URL是否正确（GitLab默认的徽章URL是正常的，但如果手动修改过可能出问题）

如果以上步骤都试过还是不行，去项目的CI/CD > Pipelines里点开对应Pipeline，查看Job的详细页面——里面有"Test coverage"字段，如果这个字段也是Unknown，说明GitLab确实没提取到数据，回到第一步重新检查日志和正则；如果这个字段有数值但徽章显示Unknown，可能是徽章缓存问题，等一会儿或者刷新页面试试。

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