Maven 编译错误：NoSuchFieldError 问题及其解决方案

2024-03-16 09:11:06

Maven 编译器插件编译错误：解决 API 中的 NoSuchFieldError

问题

在使用 mvn clean install 命令时，你可能会遇到一个恼人的错误：java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree$JCImport does not have member field 'com.sun.tools.javac.tree.JCTree qualid'. 这个问题困扰了无数开发者，也可能让你抓耳挠腮。

错误原因

罪魁祸首往往是 Java 编译器版本的不兼容。Maven 编译器插件的版本可能与你的项目使用的 Java 编译器版本不一致，导致出现 NoSuchFieldError 错误。

解决方案

1. 检查 Maven 编译器插件版本

首先，让我们检查一下你的 pom.xml 文件中的 Maven 编译器插件版本：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
</plugin>

确保该版本与你的项目使用的 Java 编译器版本兼容。

2. 更新 Java 编译器版本

如果 Maven 编译器插件版本不是问题所在，那么可以尝试更新你的 Java 编译器版本：

<properties>
  <maven.compiler.target>17</maven.compiler.target>
  <maven.compiler.source>17</maven.compiler.source>
</properties>

将 maven.compiler.target 和 maven.compiler.source 属性更新为与你的 Java 编译器版本匹配的值。

3. 使用 javac 工具

有时，Maven 编译器插件可能会出现问题。你可以尝试使用 javac 工具进行编译，并跳过 Maven 编译：

mvn clean install -Dmaven.compiler.skip=true

4. 使用 Maven Reference Plugin

另一个解决办法是使用 Maven Reference Plugin：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
  <executions>
    <execution>
      <id>default-compile</id>
      <phase>compile</phase>
      <goals>
        <goal>compile</goal>
      </goals>
      <configuration>
        <useCompilationReactor>true</useCompilationReactor>
      </configuration>
    </execution>
  </executions>
</plugin>

这将使用参考项目的编译器设置。

5. 检查依赖关系

确保你的项目没有依赖于不兼容版本的库，特别是 javax.annotation 和 javax.validation。

6. 排除依赖关系

如果排除依赖关系可以解决问题，可以在 pom.xml 文件中添加如下内容：

<dependency>
  <groupId>...</groupId>
  <artifactId>...</artifactId>
  <version>...</version>
  <exclusions>
    <exclusion>
      <groupId>com.sun.tools</groupId>
      <artifactId>javac</artifactId>
    </exclusion>
  </exclusions>
</dependency>