SonarQube项目质量门禁状态为Failed，如何排查原因并修复？

一、查看质量门失败原因 #

• 打开SonarQube对应项目的主页，找到显示为failed的Quality Gate模块，点击进入详情页
• 详情页会直接列出所有未通过的质量门规则（比如代码覆盖率不达标、新增安全漏洞、代码重复率超标等），所有失败项会以红色高亮标注
• 如需查看具体问题位置，可切换到项目的Issues标签页，查看每个问题的文件路径、代码片段；或在Measures标签页查看各项指标的详细数据

二、将质量门状态改为succeeded #

• 针对每个失败的规则逐一修复：
  • 若为代码覆盖率不足：给未被覆盖的业务逻辑补充单元测试用例
  • 若为存在安全漏洞/代码异味：根据SonarQube给出的问题提示，修改对应代码（比如修复空指针异常、优化冗余代码逻辑）
  • 若为代码重复率过高：提取重复代码为公共方法或工具类，完成代码重构
• 修复完成后，重新触发SonarQube代码扫描任务，扫描结束后系统会自动重新评估质量门，所有规则达标后状态会自动切换为succeeded
• 特殊场景下（如临时豁免），可联系SonarQube管理员调整质量门的规则阈值，但不建议随意修改，应尽量遵循团队既定的质量标准

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