编译GATK 3.4遇NoClassDefFoundError问题求助

核心原因分析 #

这个错误本质是Maven编译时找不到JDK工具类com.sun.tools.javac.main.OptionName，通常有两个关键诱因：

• Maven实际使用的JDK不是Java 8（或误使用了JRE而非JDK）
• Maven编译插件未正确绑定Java 8的编译环境

具体解决步骤 #

1. 验证Maven实际使用的JDK版本 #

执行以下命令，检查输出中的Java版本和Java Home路径：

mvn -version

• 确保输出的Java version为1.8.x
• 确保Java home指向JDK 8的根目录，而非JRE文件夹（比如/usr/lib/jvm/java-8-openjdk-amd64，而非/usr/lib/jvm/java-8-openjdk-amd64/jre）

2. 强制Maven使用Java 8编译 #

如果Maven用的不是JDK 8，可通过以下方式修正：

方式一：设置MAVEN_OPTS环境变量

• Linux/macOS终端执行：

export MAVEN_OPTS="-Djava.home=/path/to/your/jdk8"

• Windows命令提示符执行：

set MAVEN_OPTS=-Djava.home=C:\path\to\your\jdk8

方式二：修改Maven全局配置（settings.xml）

找到Maven安装目录下的conf/settings.xml（或用户目录下的.m2/settings.xml），添加如下profile：

<profiles>
  <profile>
    <id>jdk-8</id>
    <activation>
      <activeByDefault>true</activeByDefault>
      <jdk>1.8</jdk>
    </activation>
    <properties>
      <maven.compiler.source>1.8</maven.compiler.source>
      <maven.compiler.target>1.8</maven.compiler.target>
      <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
    </properties>
  </profile>
</profiles>

方式三：修改项目编译插件配置

在external-example模块的pom.xml中，修改maven-compiler-plugin的配置，强制绑定JDK 8的javac：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.1</version>
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <fork>true</fork>
        <executable>${JAVA_HOME}/bin/javac</executable>
      </configuration>
    </plugin>
  </plugins>
</build>

3. 确认JAVA_HOME配置正确性 #

再次验证JAVA_HOME指向JDK 8根目录：

• Linux/macOS：

echo $JAVA_HOME
ls $JAVA_HOME/bin/javac

• Windows：

echo %JAVA_HOME%
dir %JAVA_HOME%\bin\javac.exe

确保javac命令存在，说明是完整的JDK而非JRE。

最后重新执行编译命令：

mvn clean compile

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