SonarQube 门禁检查器

要解决的问题

代码合入前，团队通常依赖 SonarQube 的质量门禁来判断当前分支是否满足质量标准。但实际操作中，开发者需要频繁打开 Web 界面、切换项目、手动查看门禁状态，流程割裂且容易遗漏。SonarQube 门禁检查器将这一过程嵌入到本地工作流中，让你在提交合并前就能直接获知门禁结果。

核心能力

• 门禁状态查询：调用 SonarQube Web API 的 /api/qualitygates/project_status 接口，获取指定项目的门禁判定结果。
• 质量维度覆盖：报告代码异味数量、覆盖率是否达到阈值、代码重复率等关键指标，对应 SonarQube 质量配置文件中的规则。
• 合并前拦截：在 PR 流程中自动执行，门禁未通过时阻止合并，避免劣质代码进入主干。

关键步骤

1. 配置 SonarQube 服务器地址与访问令牌。
2. 指定目标项目的 key 或组件标识。
3. 调用 API 获取门禁状态，解析返回的状态码与各项指标。
4. 根据质量配置文件中的阈值判断是否通过。

适用边界与注意点

• 需要本地已安装 Native Git 并在 PATH 中可用。
• 构建项目需要 Java 17 和 npm。
• 如需跳过测试以加快构建，可在 Gradle 命令中添加 -x test。
• 门禁判断依赖于 SonarQube 服务器上的质量配置文件，规则变更需同步更新。
• 不适用于未配置 SonarQube 项目的仓库。