VSCode中Lombok正常，Maven命令行编译报符号找不到错误求助

问题场景 #

我在VSCode中结合Lombok与Maven开发，根pom.xml已配置如下依赖和插件：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version>
    <scope>provided</scope>
</dependency>

<plugin>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-maven-plugin</artifactId>
    <version>1.18.30</version>
    <executions>
        <execution>
            <phase>compile</phase>
            <goals>
                <goal>delombok</goal>
            </goals>
        </execution>
    </executions>
</plugin>

VSCode编辑时一切正常：依赖导入没问题，@Setter/@Getter注解无报错，getter/setter方法引用也能正常解析。但通过命令行执行mvn compile时，所有getter/setter调用都报“符号找不到”错误。

已完成的操作：

• IDE中安装了Lombok插件
• 执行以下命令将Lombok jar安装到本地Maven仓库，执行显示成功：

mvn install:install-file -Dfile=lombok.jar -DgroupId=org.projectlombok -DartifactId=lombok -Dversion=1.18.30 -Dpackaging=jar

解决方案 #

1. 给Maven编译插件配置Lombok注解处理器 #

当前的lombok-maven-plugin仅配置了delombok目标，它的作用是将带Lombok注解的代码转换为普通Java代码，但并没有让Maven在编译阶段自动处理Lombok注解生成getter/setter等方法。最可靠的方式是直接给maven-compiler-plugin添加注解处理器路径：

在pom.xml的<build><plugins>节点下添加或修改编译插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version> <!-- 适配你的JDK版本：JDK8用3.8.1，JDK11+可升级到3.11.0或更高 -->
    <configuration>
        <source>1.8</source> <!-- 替换为你的项目JDK版本 -->
        <target>1.8</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.30</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

2. 检查Lombok依赖的Scope配置 #

当前依赖的scope为provided，意味着Maven假设运行环境会提供该依赖，但编译阶段如果没有通过注解处理器引入Lombok，可能导致编译时无法访问注解处理逻辑。如果上述配置后问题仍存在，可以暂时注释掉scope配置（改为默认的compile）进行测试：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version>
    <!-- <scope>provided</scope> 暂时注释，测试后根据情况恢复 -->
</dependency>

3. 清理Maven缓存并重新构建 #

本地Maven仓库的依赖可能存在损坏，执行以下命令清理缓存并强制更新依赖后重新构建：

mvn clean install -U

4. 验证命令行JDK版本兼容性 #

Lombok 1.18.30支持JDK8至JDK16，确保命令行环境使用的JDK版本与项目配置一致。通过以下命令检查：

java -version
mvn -v

如果和VSCode中使用的JDK版本不一致，需要调整环境变量或Maven的toolchains.xml配置统一版本。

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