部署至GitLab Pages后Cobertura覆盖率页面显示未知问题

一、检查Cobertura报告路径与完整性 #

• 确认unit阶段生成的coverage/cobertura-coverage.xml路径正确：在CI流水线的unit阶段日志中查看该文件是否生成，或下载unit阶段的artifacts包，检查coverage目录下是否存在这个文件。若jest配置将报告输出到子目录（如coverage/cobertura/cobertura-coverage.xml），需同步修改CI配置中coverage_report.path的路径。
• 验证xml文件有效性：打开下载的cobertura-coverage.xml，确认文件格式完整无损坏，没有CI执行过程中产生的错误日志混入。

二、调整覆盖率提取正则表达式 #

CI配置中coverage: /All files[^|]*\|[^|]*\s+([\d\.]+)/用于从测试日志中提取覆盖率数值，若格式不匹配会导致GitLab显示未知：

• 查看unit阶段日志中jest输出的覆盖率表格，比如典型格式为：

  --------------------------|---------|----------|---------|---------|-------------------
  File                      | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
  --------------------------|---------|----------|---------|---------|-------------------
  All files                 |   85.71 |      100 |     100 |   85.71 |                   
  --------------------------|---------|----------|---------|---------|-------------------
  

• 根据实际输出调整正则，比如改为匹配语句覆盖率的正则：/All files\s+\|\s+([\d\.]+)/，或更精准匹配第一个数值的表达式：/All files.*?\|.*?(\d+\.\d+)/。

三、确认Pages部署的静态报告完整性 #

若问题出在GitLab Pages上的jest静态覆盖率页面：

• 检查pages阶段文件移动是否正确：在pages阶段的script中添加ls -la coverage/，确认coverage目录下的index.html等静态文件存在；mv coverage/ public/会将coverage目录完整移入public，访问路径应为https://<你的用户名>.gitlab.io/<项目名>/coverage/index.html，避免直接访问根路径。
• 对齐本地与CI环境依赖：确认CI使用的node版本、jest版本与本地一致，不同版本可能生成结构不同的报告文件，导致页面加载异常。

四、排查缓存与产物冲突 #

unit阶段同时配置了cache和artifacts存储coverage目录，可能出现缓存覆盖正确产物的情况：暂时注释掉cache配置，重新运行流水线，看覆盖率显示是否恢复正常。

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