如何将GitLab自定义工具代码质量报告基线上传至目标分支？

核心逻辑 #

GitLab的代码质量对比功能依赖目标分支最新流水线中上传的codequality报告作为基线。如果目标分支从未生成并上传过该报告，MR就无法完成对比，会显示No code quality issues found。

具体实现步骤 #

1. 为目标分支配置基线报告生成逻辑 #

在目标分支（如main/master）的.gitlab-ci.yml中，添加和MR流水线一致的代码质量报告生成与上传配置，确保每次目标分支有新提交或合并操作时，都会生成最新的基线报告：

code-quality-base:
  stage: test
  script:
    - bash ./run-test
    - bash ./prepare-code-quality-report
  artifacts:
    when: always
    reports:
      codequality: gl-code-quality-report.json
    expire_in: 30d # 延长有效期，避免基线报告提前过期无法被MR访问

2. 合并多测试任务的质量报告（适配你的多任务场景） #

如果MR流水线中有多个测试任务各自生成gl-code-quality-report.json，需要在流水线末尾新增一个独立任务，合并所有报告后再统一上传：

merge-code-quality-reports:
  stage: post-test
  needs: [test-task-1, test-task-2, test-task-3] # 依赖所有生成报告的测试任务
  script:
    # 可借助jq工具合并JSON数组，示例脚本逻辑：
    # jq -s 'add' */gl-code-quality-report.json > merged-gl-code-quality-report.json
    - bash ./merge-code-quality-reports.sh
  artifacts:
    reports:
      codequality: merged-gl-code-quality-report.json
    expire_in: 72h

注意：合并后的报告必须符合GitLab代码质量报告的JSON格式要求（数组结构，每个元素需包含description、fingerprint、location等核心字段）。

3. 验证基线报告的有效性 #

在目标分支的流水线页面，进入Artifacts -> Reports，确认Code Quality报告已成功生成并展示。只有目标分支存在有效报告时，MR的代码质量对比功能才会正常运行。

关键注意事项 #

• 不要将报告的expire_in设置过短，否则目标分支的基线报告可能提前过期，导致MR无法获取基线。
• 所有生成代码质量报告的任务，必须保证输出的JSON格式完全符合GitLab规范，否则报告无法被系统识别。
• 如果目标分支之前没有基线报告，需要手动触发一次目标分支的流水线，生成首个基线报告。

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