SonarQube v6.3.1未检测到预期问题求助（配sonar-scanner v3.0.3.778）

嘿，我来帮你排查这个头疼的问题——我之前用旧版SonarQube的时候也碰到过类似的情况，咱们一步步拆解可能的原因：

1. 深挖扫描日志的细节 #

你说控制台有加载和扫描信息，但一定要盯着日志里的细节看：

• 有没有出现 Skipping file... 这类提示？这大概率是扫描器没把你植入问题的文件纳入扫描范围
• 有没有隐藏的报错？比如规则集加载失败、文件解析出错（旧版本扫描器有时候不会把错误标得很显眼）
• 核对日志里统计的扫描文件数量，确认你说的两个目标文件都被列进去了

如果拿不准，直接给扫描命令加 -X 参数开启调试模式：

./sonar-scanner -X

调试日志会把每一步的规则应用、文件处理过程都列出来，很容易找到线索。

2. 检查SonarQube项目的配置 #

登录网页端进入你的项目，重点看这两个地方：

• 项目设置 → 分析范围：有没有不小心把问题文件加入了排除列表？比如 sonar.exclusions 参数是不是误写了路径，或者 sonar.inclusions 没包含你的目标文件目录
• 项目设置 → 质量配置文件：确认当前用的配置文件包含了你要检测的规则。比如你刻意加了代码异味，那对应的规则（比如重复代码、未使用变量、硬编码密码这类）是不是都启用了？旧版本的默认配置可能会关掉一些小众规则

3. 确认扫描命令的参数是否正确 #

你从扫描器bin目录执行 ./sonar-scanner，有没有传对必要的参数？比如：

• 有没有指定 sonar.sources 指向你的问题文件所在目录？如果没指定，扫描器可能只扫了默认的 src 目录，没覆盖你放测试代码的文件夹
• 有没有明确指定 sonar.projectKey？如果多个项目用了相同的key，扫描结果可能被覆盖到其他项目里了
• 检查 sonar.language 参数（如果指定了），是不是和你的代码语言匹配？比如你写的是Java代码，但不小心指定了 js，那规则肯定不会生效

4. 版本兼容性的坑 #

你用的SonarQube 6.3.1是2017年的老版本，虽然sonar-scanner 3.0.3.778理论上兼容，但旧版本组合容易出奇怪的问题：

• 检查SonarQube服务器上的语言插件版本，比如Java插件、JavaScript插件，是不是和6.3.1版本匹配？插件版本不兼容的话，规则根本没法正常运行
• 试试重启SonarQube服务器，旧版本有时候会因为缓存问题导致规则不加载

5. 确认问题代码符合规则触发条件 #

有时候我们觉得是明显的问题，但SonarQube的规则有特定触发逻辑：

• 比如你植入的重复代码，是不是没达到默认阈值？旧版本SonarQube默认要求重复10行以上才会标记，如果你只复制了几行，可能不会被检测到
• 比如你植入的Bug，是不是不在当前规则的覆盖范围内？比如你写了空指针风险，但对应的规则没在质量配置文件里启用

先从开启调试日志开始吧，这是最快找到问题根源的方法——调试日志会明确告诉你每个文件被怎么处理，规则有没有真正应用到上面。

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