如何在GitLab CI/CD的Tests标签页正确展示JUnit5测试输出

核心配置步骤 #

1. 确认测试报告位置 #

先确认你的JUnit XML报告（TEST*Name_of_Test.xml）生成路径，常见场景：

• Maven项目：通常在target/surefire-reports/目录下
• Gradle项目：通常在build/test-results/test/目录下

2. 修改.gitlab-ci.yml配置 #

在你的测试阶段任务中，添加artifacts.reports.junit配置，指定测试报告的路径（支持通配符）。示例配置如下：

stages:
  - build
  - test

test:
  stage: test
  script:
    # 替换成你实际的测试执行命令，比如mvn test或gradle test
    - ./mvnw test
  artifacts:
    reports:
      # 这里替换成你的XML报告实际路径，通配符*匹配所有对应文件
      junit: target/surefire-reports/TEST*.xml
    # 可选：保留报告文件作为产物，方便后续查看原始内容
    paths:
      - target/surefire-reports/TEST*.xml

3. 验证效果 #

提交修改后的.gitlab-ci.yml到仓库，触发新的流水线。流水线执行完成后，进入项目的Tests标签页，就能看到每个测试用例的名称、耗时、状态（通过/失败/跳过）明细，失败的测试还能展开查看具体报错信息。

常见问题排查 #

• 报告格式问题：确保XML文件符合JUnit规范，包含<testcase>标签，且每个测试用例的name、time等属性完整。可以直接打开XML文件检查格式是否正确。
• 路径配置错误：在测试脚本中添加ls -la 你的报告路径命令，确认是否生成了预期的XML文件，路径是否和配置一致。
• GitLab版本限制：GitLab 12.0及以上版本才支持完整的JUnit测试详情展示，若使用旧版本建议升级。

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