解决Lombok注解处理器错误：lombok.eclipse.handlers.HandleBuilder失败

问题背景 #

Windows 11环境下，用VSCode 1.87.2开发Java项目，项目依赖Lombok 1.18.24，用到了@Builder、@Data、@EqualsAndHashCode等注解。用Eclipse 2024-03 R打开过该项目后，回到VSCode时，所有使用Lombok注解的类全报错，项目无法编译，根源是Lombok注解处理器异常，已有其他开发者遇到相同问题。

已尝试的无效操作 #

• 更新Lombok至最新版1.18.32
• 卸载Eclipse或更换旧版本Eclipse
• 删除用户配置文件后重新配置JDK和Maven环境

可行修复方案 #

1. 重置VSCode Java插件的注解处理器配置 #

• 打开VSCode设置（快捷键Ctrl+,），搜索java.compiler.annotationProcessing.enabled，确保该选项处于勾选状态
• 继续搜索java.compiler.annotationProcessing.processors，手动添加处理器路径：lombok.launch.AnnotationProcessorHider$AnnotationProcessor
• 保存设置后，按Ctrl+Shift+P调出命令面板，执行Java: Clean Java Language Server Workspace，完成后重启VSCode

2. 给Maven项目手动指定Lombok注解处理器 #

在项目的pom.xml中添加以下配置，强制指定注解处理器，覆盖可能被Eclipse修改的项目设置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>17</source> <!-- 替换成你实际使用的JDK版本 -->
                <target>17</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.32</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

配置完成后执行mvn clean install，再重新导入项目到VSCode。

3. 清除Eclipse残留的项目配置文件 #

Eclipse会在项目根目录生成专属配置文件，这些文件会干扰VSCode的Java语言服务：

• 关闭VSCode和Eclipse
• 删除项目根目录下的.settings文件夹、.project和.classpath文件
• 重新打开VSCode，执行Java: Import Maven Projects重新导入项目

官方修复进展说明 #

该问题属于VSCode Java插件与Eclipse项目配置冲突的已知问题，官方正在跟进处理。如果上述方案都无法解决问题，可以等待VSCode Java插件的更新版本，官方修复后即可恢复正常。

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