java: java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree

### Java 编译时出现 `java.lang.NoSuchFieldError` 错误的解决方案 当项目从 JDK 17 升级至 JDK 21 后，可能会遇到如下错误： ``` java: java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree$JCImport does not have member field 'com.sun.tools.javac.tree.JCTree qualid' ``` 此问题的根本原因是，在 JDK 21 中，`qualid` 字段的类型发生了变更，从 `JCTree` 更改为 `JCFieldAccess`[^4]。这种类型的更改使得 Lombok 或其他工具无法正确访问该字段，进而引发 `NoSuchFieldError`。 以下是解决问题的具体方法： #### 方法一：升级 Spring Boot 版本 如果当前使用的 Spring Boot 是较低版本（如 3.1.2），建议将其升级到 **3.1.4** 或更高版本。Spring Boot 的新版本修复了与此问题相关的兼容性缺陷[^5]。 可以通过修改项目的 `pom.xml` 文件来完成升级操作： ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.1.4</version> <!-- 至少为 3.1.4 --> </parent> ``` #### 方法二：更新 Lombok 版本 Lombok 工具可能未适配 JDK 21 的内部 API 变更。因此，需确保使用最新版 Lombok 来解决此类问题。可以在 `pom.xml` 中指定最新的 Lombok 版本号： ```xml <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version> <!-- 使用最新稳定版本 --> <scope>provided</scope> </dependency> ``` #### 方法三：禁用特定功能以绕过问题 作为临时措施，可以尝试通过配置文件禁用某些可能导致冲突的功能。例如，关闭 Lombok 的代理生成器或其他高级特性。在 `lombok.config` 文件中添加以下内容： ```properties lombok.addJacksonAnnotations=false lombok.anyConstructor.suppressConstructorProperties=true ``` #### 方法四：回退 JDK 版本 如果上述方法均不可行，可考虑暂时将 JDK 回滚至较旧版本（如 JDK 17）。虽然这不是长久之计，但在紧急情况下可以帮助恢复服务运行。 --- ### 总结 为了彻底解决 `java.lang.NoSuchFieldError` 错误，推荐优先执行以下两项操作： 1. 将 Spring Boot 升级至 **3.1.4** 或以上版本； 2. 更新 Lombok 到其最新稳定版本。 这些调整能够有效应对因 JDK 内部结构变更而导致的不兼容问题。 ---