如何解决Maven中已配置正确Lombok版本仍出现的JCTree qualid错误？

问题分析 #

这个错误确实是Lombok与JDK版本不兼容导致的——JDK17对javac内部结构做了调整，旧版本Lombok无法适配新的JCTree$JCImport类结构。你提到其他模块配置一致但正常构建，大概率是这个模块存在隐性依赖冲突，或者编译配置的细节差异。

解决步骤 #

1. 升级Lombok到适配JDK17的稳定版本
   你当前使用的Lombok 1.18.30虽声称支持JDK17，但部分场景下仍存在适配问题，建议升级到更稳定的版本（比如1.18.32或更高）。同时在properties中统一版本变量，避免依赖和注解处理器版本不一致：

   <properties>
       <java.version>17</java.version>
       <lombok.version>1.18.32</lombok.version>
       <maven-compiler-plugin.version>3.10.1</maven-compiler-plugin.version>
   </properties>
   

2. 明确指定maven-compiler-plugin版本
   你的配置中使用了${maven-compiler-plugin.version}但未定义该变量，Spring Boot Parent的默认版本可能存在适配问题。明确指定适配JDK17的编译器插件版本，确保编译过程稳定：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <version>${maven-compiler-plugin.version}</version>
       <configuration>
           <source>17</source>
           <target>17</target>
           <annotationProcessorPaths>
               <path>
                   <groupId>org.projectlombok</groupId>
                   <artifactId>lombok</artifactId>
                   <version>${lombok.version}</version>
               </path>
               <path>
                   <groupId>org.mapstruct</groupId>
                   <artifactId>mapstruct-processor</artifactId>
                   <version>1.5.0.Final</version>
               </path>
           </annotationProcessorPaths>
           <compilerArgs>
               <compilerArg>-Amapstruct.defaultComponentModel=spring</compilerArg>
           </compilerArgs>
       </configuration>
   </plugin>
   

3. 排查依赖传递冲突
   执行以下命令查看模块的依赖树，检查是否有其他依赖（比如你引入的org.example:RegisterEndpointInformation）传递引入了低版本Lombok：

   mvn dependency:tree -Dincludes=org.projectlombok:lombok
   

   如果发现冲突，在对应的依赖中排除低版本Lombok：

   <dependency>
       <groupId>org.example</groupId>
       <artifactId>RegisterEndpointInformation</artifactId>
       <version>1.0-SNAPSHOT</version>
       <scope>compile</scope>
       <exclusions>
           <exclusion>
               <groupId>org.projectlombok</groupId>
               <artifactId>lombok</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

4. 清理缓存后重新构建
   清理Maven本地缓存和IDE缓存，避免旧依赖干扰：

   mvn clean install -U
   

   同时在IDE中执行缓存清理操作（比如IntelliJ IDEA的File -> Invalidate Caches...），再重新构建模块。

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