GitLab CE项目覆盖率徽章始终显示unknown问题求助

• 确认徽章URL参数准确性

  • 不指定任务的基础格式：https://<你的GitLab域名>/<项目路径>/badges/<目标分支>/coverage.svg，目标分支需选择有有效覆盖率数据的分支（如main/master），而非临时分支。
  • 指定任务的格式：需在URL末尾追加?job=run_tests_job，注意任务名必须与CI配置中的任务名完全一致，大小写、特殊字符均需匹配。

• 验证全局覆盖率解析规则
  进入项目的Settings > CI/CD > General pipelines，检查「Test coverage parsing」规则是否能精准匹配CI任务输出的覆盖率格式。例如任务输出为Test Coverage: 92.5%，则解析规则需设为Test Coverage:\s*(\d+\.?\d*)%，确保GitLab能正确捕获覆盖率数值。

• 确认目标分支的流水线数据
  检查目标分支的最新成功流水线：

  1. 进入项目CI/CD > Pipelines，找到目标分支的最新成功流水线；
  2. 查看run_tests_job的日志，确认覆盖率数值已正确输出；
  3. 在流水线详情页确认「Test coverage」字段显示了正确的百分比数值——只有该字段有值，徽章才能读取到数据。

• 检查徽章访问权限

  • 若项目为私有项目，需在徽章URL中追加私有令牌参数：&private_token=<你的访问令牌>，确保能正常访问徽章资源；
  • 进入Settings > General > Visibility, project features, permissions，确认「Badges」功能处于开启状态。

• 强制刷新徽章缓存
  GitLab会缓存徽章数据，可在徽章URL末尾添加随机参数（如&v=123）强制刷新，或等待10-30分钟让缓存自动失效后再查看。

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