使用技巧

测试已经运行，报告也保存了，SonarQube页面却没有显示用例数量，问题可能出在报告路径、格式或分析状态上。“SonarQube怎么导入测试执行报告SonarQube测试执行数据导入后没有显示如何检查”需要结合测试工具和扫描方式处理。下面以Python项目、pytest和SonarScanner CLI为例，说明配置与排查步骤。测试执行报告记录用例结果和耗时，与覆盖率报告需要分别导入。

SonarQube中的Cognitive Complexity用于衡量代码控制流程的理解难度，与Cyclomatic Complexity侧重统计执行路径不同。项目中的认知复杂度可以在Measures中查看，并逐步下钻到目录和文件；如果要继续定位具体函数，则需要结合认知复杂度规则产生的Issue进行检查。项目指标很高却找不到对应Issue时，还要区分“累计指标”和“单个函数规则阈值”这两种计算结果。

SonarQube可以把第三方静态分析工具产生的问题导入项目，与自身检测出的Issue一起查看。对于已经适配SonarQube的工具，可以使用对应的报告参数；其他分析器可以转换成Generic Issue格式或SARIF格式再导入。报告文件已经生成但SonarQube页面没有显示问题时，要先确认Scanner实际读取到了报告，再检查报告格式、源码路径、分析范围和当前查看的分支，不能只看报告文件是否存在。

SonarScanner显示EXECUTION SUCCESS，项目页面却迟迟没有新结果，这种情况并不少见。扫描器只是把分析报告上传到服务器，后续还要交给Compute Engine处理。后台任务没跑完，结果就不会正式进入项目。

SonarQube里的“质量配置”通常指Quality Profile，它决定某种编程语言启用哪些检查规则。团队想给新项目沿用现有标准时，复制一份很方便。麻烦也常出在这里。明明从同一个配置复制，过一段时间再看，规则数量却对不上。遇到这种情况，别急着一条条手工补，先确认用的是复制、继承，还是跨服务器导入。

SonarQube Webhook的配置，和推送失败时的排查，重点并不只是填进去一个回调地址就完成了，而是要去确认这个地址，能够被SonarQube的服务器正常访问到，并且接收的那一端，也能够正确地识别出推送过来的内容。Webhook这个东西，通常是用来把扫描完成、质量门禁的状态这一类结果，推送给Jenkins、GitLab、企业微信、钉钉，或者是公司内部的平台。SonarQube它支持项目这一级，和全局这一级的Webhook配置，项目级的，是可以在项目的设置里面去配，全局级的，则是可以在系统的管理里面去配。