添加Groovy类后，Groovy Eclipse Compiler无法找到lombok.launch.Agent如何解决？

我之前在混合Java/Lombok和Groovy的Maven项目里也碰到过完全一样的问题——明明Lombok jar就在本地仓库里，但Groovy编译器就是找不到Agent类。下面是几个亲测有效的解决步骤：

• 强制Groovy编译器加载Lombok JavaAgent
  Groovy Eclipse Compiler默认可能不会自动把Lombok的Agent类纳入编译classpath，你需要在maven-compiler-plugin的配置里显式指定JavaAgent路径，同时确保插件依赖中包含Lombok。修改pom.xml配置如下：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
      <configuration>
          <compilerId>groovy-eclipse-compiler</compilerId>
          <!-- 必须开启fork，否则JavaAgent无法生效 -->
          <fork>true</fork>
          <compilerArgs>
              <arg>-javaagent:${settings.localRepository}/org/projectlombok/lombok/1.16.16/lombok-1.16.16.jar</arg>
          </compilerArgs>
      </configuration>
      <dependencies>
          <dependency>
              <groupId>org.codehaus.groovy</groupId>
              <artifactId>groovy-eclipse-compiler</artifactId>
              <!-- 这个版本和Lombok 1.16.16兼容，别用太新的版本 -->
              <version>3.7.0</version>
          </dependency>
          <dependency>
              <groupId>org.projectlombok</groupId>
              <artifactId>lombok</artifactId>
              <version>1.16.16</version>
          </dependency>
      </dependencies>
  </plugin>
  

  这里的<fork>true</fork>是核心，它会让编译器在独立进程中运行，确保JavaAgent能被正确加载。

• 检查版本兼容性
  你用的Lombok 1.16.16是比较旧的版本，一定要搭配兼容的Groovy Eclipse Compiler版本。比如上面配置里的3.7.0版本，和Lombok 1.16.x系列完全匹配，如果用了4.x以上的Groovy编译器版本，很可能会出现类路径不兼容的问题。

• 清理Maven缓存并重新构建
  有时候Maven本地仓库的缓存可能损坏，或者旧的构建状态残留导致问题。执行以下命令强制清理并重新构建：

  mvn clean install -U
  

  -U参数会强制更新依赖快照，确保你拿到的是完整无损坏的Lombok jar包。

• 同步IDE配置（如果在IDE中构建）
  如果你是在IDE（比如IntelliJ或Eclipse）里执行构建，还要确保IDE配置和Maven一致：

  • 安装Lombok官方插件
  • 开启注解处理功能（比如IntelliJ中：Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors，勾选Enable annotation processing）
  • 让IDE使用Maven的构建配置，而非自带的编译器设置

内容的提问来源于stack exchange，提问作者Mr. Wrong