自定义Java Maven插件致SonarQube启动失败问题求助

问题核心 #

插件部署后启动SonarQube时触发NoClassDefFoundError，找不到org.sonarsource.analyzer.commons.RuleMetadataLoader类，根源是依赖未被正确打包或存在版本兼容性冲突。

关键报错片段 #

Caused by: java.lang.NoClassDefFoundError: org/sonarsource/analyzer/commons/RuleMetadataLoader
    at com.plugins.sonar.java.SonarqubeJavaRulesDefinition.define(SonarqubeJavaRulesDefinition.java:44)
Caused by: java.lang.ClassNotFoundException: org.sonarsource.analyzer.commons.RuleMetadataLoader

修复步骤 #

1. 修正依赖打包配置 #

pom.xml中设置的<sonar.skipDependenciesPackaging>true</sonar.skipDependenciesPackaging>会阻止sonar-analyzer-commons等依赖打包进插件jar，导致运行时类缺失：

• 移除properties中的该配置项，或者在sonar-packaging-maven-plugin的配置中明确启用依赖打包：

  <configuration>
    <!-- 其他配置保持不变 -->
    <skipDependenciesPackaging>false</skipDependenciesPackaging>
  </configuration>
  

2. 统一SonarQube相关依赖版本 #

sonar-plugin-api-impl使用的9.7.1版本与SonarQube服务器9.4版本不匹配，会引发类加载冲突：

• 将sonar-plugin-api-impl的版本改为与sonarqube.version一致：

  <dependency>
    <groupId>org.sonarsource.sonarqube</groupId>
    <artifactId>sonar-plugin-api-impl</artifactId>
    <version>${sonarqube.version}</version>
  </dependency>
  

3. 确认依赖范围 #

确保sonar-analyzer-commons依赖的范围为默认的compile（无需显式设置<scope>），这样Maven会自动将其打包进插件jar：

<dependency>
  <groupId>org.sonarsource.analyzer-commons</groupId>
  <artifactId>sonar-analyzer-commons</artifactId>
  <version>2.1.0.1111</version>
</dependency>

4. 重新构建部署 #

执行以下命令重新打包插件：

mvn clean package

将生成的jar文件替换到SonarQube的../extensions/plugins目录，重启SonarQube即可。

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