GitLab自定义Code Quality报告无法正常展示代码问题求助

1. 修复JSON格式的隐性语法错误 #

你的示例JSON最后一个对象末尾多了一个逗号，部分宽松的JSON解析器可以容忍，但GitLab的Code Quality解析器严格遵循JSON规范，这个多余的逗号会导致解析失败。请修正为合规格式：

[
   {
      "type": "issue",
      "check_name": "Error",
      "description": "Unexpected keyword argument 'self' in function call",
      "categories": "Error",
      "fingerprint": "7c1f2ce887b2f1e2e4c1549f6901c18f",
      "severity": "major",
      "location": {
         "path": "company_set/create_user.py",
         "lines": {
            "begin": "98"
         }
      }
   },
   {
      "type": "issue",
      "check_name": "Error",
      "description": "Unexpected keyword argument 'self' in function call",
      "categories": "Error",
      "fingerprint": "7c1f2ce887b2f1e2e4c1549f6901c18f",
      "severity": "major",
      "location": {
         "path": "project/compare_data.py",
         "lines": {
            "begin": "118"
         }
      }
   }
]

2. 验证severity字段的取值合规性 #

GitLab对severity字段有严格的可选值要求，必须是info/minor/major/critical/blocker中的一个。你的示例取值major合规，但需排查实际生成的报告中是否存在拼写错误（比如首字母大写Major），这类错误会导致问题被系统忽略。

3. 核对报告文件的路径与权限 #

• 确认gl-code-quality-report.json生成在流水线工作目录的预期位置，若文件不在根目录，需在artifacts.reports.codequality中指定完整相对路径（比如reports/gl-code-quality-report.json）。
• 检查生成该文件的CI步骤是否有足够权限创建、写入文件，避免文件为空或内容截断。

4. 查看流水线解析日志 #

在流水线的制品处理或Code Quality相关步骤日志中，查找是否有JSON解析失败、字段缺失等错误提示，这是定位问题最直接的途径。

5. 确保fingerprint的唯一性 #

示例中两个问题共用同一个fingerprint会导致GitLab合并显示，但不会全部忽略。建议为每个问题生成唯一的fingerprint（比如基于文件路径、行号、检查规则的哈希值），保证问题能被正确识别区分。

6. 检查CI配置的YAML语法 #

YAML对缩进敏感，确认artifacts配置的缩进层级正确，避免因语法错误导致报告配置不生效：

artifacts:
  paths:
    - pylama.txt
    - pylama.svg
  reports:
    codequality: gl-code-quality-report.json

内容的提问来源于stack exchange，提问作者jo.oj