GitLab合并请求(MR)组件不显示代码质量报告，请求协助排查

云上老周

2026-7-6

GitLab MR代码质量报告不显示的排查步骤

确认报告格式合规：GitLab只识别Code Climate格式的JSON报告（通常命名为gl-code-quality-report.json）。打开制品里的报告文件，检查是否包含issues数组，每个issue需有description、location（含path、lines）、severity等核心字段，格式错误会导致无法识别。
检查CI/CD的artifacts配置：必须在作业中配置artifacts:reports:codequality字段，而不是仅用paths。正确配置示例：
```
code_quality:
  script:
    # 替换为你的报告生成命令
    - codeclimate analyze --format json > gl-code-quality-report.json
  artifacts:
    reports:
      codequality: gl-code-quality-report.json
```
仅设置paths只会把文件存为普通制品，不会被MR的代码质量组件识别。
验证报告来自MR流水线：代码质量报告必须由MR触发的流水线生成，分支独立流水线的报告不会同步到MR。去MR的「流水线」标签页，确认代码质量作业已在MR流水线中执行成功。
检查项目权限与功能开关：确保你有该MR的流水线和制品查看权限；同时去项目「设置」→「可见性、项目功能、权限」→「CI/CD」，确认「代码质量」功能已启用（和MR组件的复选框是两个不同设置）。
排查GitLab版本问题：旧版本（如14.x之前）可能存在报告识别bug，若使用旧版，建议升级到官方稳定版，或查阅对应版本的GitLab文档确认配置要求。
查看作业日志找异常：进入代码质量作业的执行日志，搜索是否有文件写入失败、报告生成报错等信息，这些隐性错误会导致报告内容无效，无法被识别。