SonarLint在IntelliJ中无反应，主因是未绑定项目或Java语言支持未启用；需检查绑定状态、开启Java规则集、确认模块被识别为Java源码目录。
IntelliJ 中 SonarLint 插件没反应？检查绑定状态和语言支持
SonarLint 在 IntelliJ 里不报错、不标红，大概率是没真正“连上”项目或语言未启用。它默认只对已识别为 Java 模块的源码生效，且需手动开启 Java 规则集。
- 右键项目根目录 → SonarLint → Bind to SonarQube/SonarCloud，即使本地用，也建议选
Local analysis only（避免误配远程服务器） - 进
Settings → Other Settings → SonarLint → Rules，确认Java语言开关已打开，且规则集不是空的（如sonar-way） - 检查模块是否被识别为 Java：
Project Structure → Modules里，对应 module 的Source Folders是否标记为Sources（而非普通文件夹） - 常见错误现象：
File is not analyzed: language not supported—— 这说明当前文件后缀或编码方式未被 SonarLint 的 Java 解析器捕获，优先检查.java文件是否在src/main/java下且路径被正确标记
mvn sonar:sonar 报 ClassNotFoundException: org.sonar.api.SonarPlugin
这是 Maven 执行 SonarQube 扫描时典型的插件版本错配问题，根本原因是 sonar-maven-plugin 版本太老，不兼容新版本 SonarQube 或 JDK。
- 必须使用与 SonarQube 服务端大版本匹配的插件：SonarQube 9.x 要求
sonar-maven-plugin≥ 3.9.1；8.x 对应 3.7.0～3.8.0 - 在
pom.xml中显式声明插件版本，不要依赖 Maven 默认继承的旧版：<build> <plugins> <plugin> <groupId>org.sonarsource.scanner.maven</groupId> <artifactId>sonar-maven-plugin</artifactId> <version>3.9.1.2184</version> </plugin> </plugins> </build> - JDK 17+ 用户注意：低于 3.9.0 的插件会因反射限制直接抛
NoClassDefFoundError，不是配置问题，是硬性不兼容
IDEA 里 SonarLint 和 Maven 扫描结果不一致
这不是 bug，是设计使然：IDEA 中 SonarLint 基于编辑器 AST 实时分析（快但简化），Maven sonar:sonar 走完整编译 + 字节码解析（准但重）。两者规则启用、上下文感知、依赖可见性都不同。
- SonarLint 默认不加载项目依赖的 JAR（比如 Spring Boot starter），所以对
@Autowired、Lombok@Data等注解感知弱，容易漏报 NPE 相关规则 - Maven 扫描能读取
target/classes和所有dependency，因此像java:S1192（重复字符串字面量）这类需跨类分析的规则，只在 Maven 扫描中触发 - 参数差异关键点：
sonar.java.binaries（Maven 必须设为target/classes）和sonar.java.libraries（指定target/dependency/*.jar）缺一不可，否则类型解析失败，大量规则失效
CI 流水线跑 sonar:sonar 卡在 EXECUTION FAILURE 且无具体错误
最常被忽略的是工作目录和模块结构不匹配——SonarScanner 不会自动递归找 pom.xml，它只扫描当前目录下能 resolve 出 Maven 项目的路径。
立即学习“Java免费学习笔记（深入）”；
- 确保 CI 命令执行位置是含
pom.xml的根目录，不是子模块目录（除非你明确想只扫那个模块） - 多模块项目必须加
-Dsonar.modules=module-a,module-b，否则只扫根 pom，子模块代码不进分析范围 - 常见静默失败原因：
sonar.host.url配了但网络不通，或 token 权限不足（返回 401 却被 Scanner 吞掉日志），建议先本地用mvn sonar:sonar -X开启 debug 日志看真实 HTTP 响应 - 性能影响提示：若项目含大量测试代码，务必加
-Dsonar.exclusions=**/test/**,**/Test*.java，否则分析时间翻倍且污染质量门禁指标
