SonarQube 规则执行代理

解决的问题

在合并请求阶段，代码质量检查常常依赖人工 review。即使团队引入了 SonarQube，分析结果也往往停留在仪表盘上。一旦关键的代码异味、安全热点或重复率超标，没有自动拦截手段时，这些信号很容易被忽略，最终进入主干。

核心能力

该技能通过 SonarQube Web API 与 sonar-scanner CLI 协同工作，把质量门禁嵌入拉取请求流程。核心步骤包括：

• 扫描变更代码：调用 sonar-scanner 对当前分支或差异进行静态分析
• 提取质量指标：通过 Web API 获取关键异味、安全热点与重复率等指标
• 阈值判定：依据可配置的阈值，判断是否触发阻断条件
• 合并拦截：发现超标项时，直接阻止合并操作，直到问题被修复

适用边界与注意点

使用前需要确保环境具备完整依赖。根据上游文档，Native Git 必须已安装并在 PATH 中可用。构建方面要求 Java 17 和 npm，二者缺一不可。

如果贡献中包含 UI 变更，流程会更复杂。需要先克隆 sonarqube-webapp 仓库，在其中完成修改并本地构建，再通过 WEBAPP_BUILD_PATH 环境变量构建 SonarQube 主仓库。

测试环节可以通过在 gradle 命令中添加 -x test 来跳过，这在只做构建验证时比较有用。当前版本未提及对自托管实例或私有化部署的特殊适配，接入前建议先验证 API 兼容性。