MacOS下微服务项目Lombok相关编译问题排查求助

针对你遇到的Lombok @Getter/@Setter注解编译时无法生成对应方法的问题，以下是几个直接有效的修复步骤：

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

你的pom.xml中仅添加了Lombok依赖，但没有配置Maven编译插件来启用Lombok的注解处理器——这是核心问题。修改build段，添加maven-compiler-plugin配置：

<build>
    <plugins>
        <!-- 新增编译插件配置，启用Lombok注解处理器 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version> <!-- 可根据你的Maven版本选择合适的插件版本 -->
            <configuration>
                <source>17</source> <!-- 替换为你的项目使用的Java版本 -->
                <target>17</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.30</version> <!-- 替换为你的pom中Lombok的实际版本 -->
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>

        <!-- 保留Spring Boot插件，移除Lombok排除项（如果还存在的话） -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

2. 验证Java与Lombok版本兼容性 #

Lombok对不同Java版本有兼容要求，确保你的版本匹配：

• Java 8：Lombok 1.18.x全系列支持
• Java 11：需Lombok 1.18.12及以上
• Java 17/21：需Lombok 1.18.20及以上
  可以通过以下命令查看当前版本：

# 查看Java版本
java -version

# 查看项目中Lombok版本
mvn dependency:tree | grep lombok

3. 确认Maven使用的Java环境 #

MacOS可能同时存在多个Java版本，需确保Maven使用的是你项目指定的JDK：

# 查看Maven关联的Java版本
mvn -v

如果版本不符，可通过设置JAVA_HOME环境变量指向正确的JDK路径，或者在IDE中配置Maven的JDK。

4. 清理Maven缓存并重新编译 #

旧的依赖缓存可能导致异常，执行以下命令强制清理并重新构建：

mvn clean install -U

5. IDE注解处理配置（如果使用IDE编译） #

如果你通过IntelliJ/Eclipse等IDE编译项目，需确保：

• 已安装Lombok插件
• 启用了注解处理：
  • IntelliJ：Settings > Build, Execution, Deployment > Compiler > Annotation Processors，勾选"Enable annotation processing"
  • Eclipse：Preferences > Java > Compiler > Annotation Processing，勾选"Enable annotation processing"

补充说明 #

Windows环境下正常工作，大概率是因为IDE自动帮你配置了注解处理器，或者之前的pom中隐含了相关配置；而MacOS下Maven编译需要显式声明注解处理器路径才能让Lombok生效。

内容的提问来源于stack exchange，提问作者Luís Casqueiro