使用SonarQube 9.9分析Java 8项目时遇API兼容性错误求助

错误原因分析 #

报错中的java.lang.UnsupportedClassVersionError明确说明：org/sonar/batch/bootstrapper/EnvironmentInformation类是用Java 11（类文件版本55.0）编译的，但当前运行Maven的Java版本仅支持到Java 8（类文件版本52.0）。

这是因为SonarQube 9.9及对应的扫描器插件要求运行环境为Java 11+，即使你要分析的应用是Java 8编写的，扫描过程本身需要更高版本的JDK来执行。你之前修改的maven.compiler.source/target仅控制应用代码的编译版本，不影响Maven插件的运行环境。

解决方案 #

1. 切换运行Maven的JDK版本到11+ #

执行Sonar扫描时，确保Maven使用的JDK是11或更高版本：

• 临时切换：在执行Sonar命令前，设置环境变量JAVA_HOME指向JDK11路径，例如：

  # Linux/Mac
  export JAVA_HOME=/path/to/jdk11
  mvn sonar:sonar
  
  # Windows
  set JAVA_HOME=C:\path\to\jdk11
  mvn sonar:sonar
  

• 永久配置：修改Maven的conf/settings.xml，添加profile指定默认JDK版本：

  <profiles>
    <profile>
      <id>jdk11</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.release>8</maven.compiler.release>
      </properties>
    </profile>
  </profiles>
  

  同时确保JAVA_HOME全局指向JDK11，应用代码的编译仍会保持Java 8版本。

2. 确保Sonar插件与服务器版本兼容 #

SonarQube 9.9需要搭配3.9.0.2155及以上版本的sonar-maven-plugin，你当前使用的3.6.0版本过于老旧，存在兼容性问题。更新插件版本：

<plugin>
  <groupId>org.sonarsource.scanner.maven</groupId>
  <artifactId>sonar-maven-plugin</artifactId>
  <version>3.9.1.2184</version>
</plugin>

3. 使用Maven Toolchains插件指定扫描用JDK #

如果你的系统需要同时维护多个JDK版本，可以用Toolchains插件指定执行Sonar扫描时使用JDK11：

1. 在用户目录下创建~/.m2/toolchains.xml（Windows为C:\Users\<用户名>\.m2\toolchains.xml）：

<?xml version="1.0" encoding="UTF-8"?>
<toolchains>
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>11</version>
      <vendor>openjdk</vendor>
    </provides>
    <configuration>
      <jdkHome>/path/to/jdk11</jdkHome>
    </configuration>
  </toolchain>
</toolchains>

2. 在pom.xml中配置Toolchains插件，绑定到Sonar目标：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-toolchains-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
          <goals>
            <goal>toolchain</goal>
          </goals>
        </execution>
      </executions>
      <configuration>
        <toolchains>
          <jdk>
            <version>11</version>
          </jdk>
        </toolchains>
      </configuration>
    </plugin>
  </plugins>
</build>

内容的提问来源于stack exchange，提问作者a.k.od