SpringBoot项目Lombok注解失效问题

今天在写一个新的项目，写好两个接口之后就想启动测试一下，但是启动之后却发现大量的报错信息：

@Slf4j注解失效：

方法中输出日志信息的方法被认为该方法不存在，显然是Lombok的依赖有问题

构造方法和Get/Set方法失效：

与日志失效同理，显然是因为Lombok中的注解@Data、@NoArgsConstructor、@AllArgsConstructor等无法失效，不能为实体类生成对应的构造方法和Getter/Setter方法

问题原因

这个问题出现的原因是我们在创建SpringBoot项目的时候，在勾选起步依赖的地方把LomBok勾选上了，但是SpringBoot并不会指定LomBook版本：

<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<optional>true</optional>
</dependency>

这就会导致项目使用的jar包无法确定版本，导致失效问题，可以在设置->构建、执行、部署->编译器->注释处理器中查看，点击我们的项目，在处理器路径中可以看到，lombok的jar包版本为unknown

---

解决方法

其实只需要把上图中的处理器路径改成我们Maven仓库中一个指定版本的lombok依赖的jar包就可以：

但这并不是长久之计，每次刷新pom.xml文件，Maven都会帮我们把依赖路径改回去，完全修改需要三步：

1. 重新引入依赖

将spring boot引入的起步依赖删除，我们重新引入一个指定版本的lombok依赖：

<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.20</version>
</dependency>

2. 删除多余配置

在你引入lombok起步依赖之后，pom.xml文件中也会生成一段配置：

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <annotationProcessorPaths>
                        <path>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

这段配置的作用就是通过maven-compiler-plugin插件，指定Lombok作为注解处理器路径（annotationProcessorPaths），并且在spring-boot-maven-plugin插件中，通过<excludes>排除了Lombok依赖，这就会导致总是自动修改我们的处理器路径为unkonwn

3.更改处理器路径

这步就是处理器路径改成我们Maven仓库中一个指定版本的lombok依赖的jar包，上面也已经演示过了

---

如果通过上述的方法你的项目依然存在报错情况，那么可以检查以下问题：

1. 检查安装 Lombok 插件
在 IntelliJ IDEA 中：

• 打开 File → Settings → Plugins
• 搜索 Lombok 检查是否安装插件，重启 IDE

---

2. 清理并重新构建项目

• IntelliJ IDEA：
  点击菜单 Build → Rebuild Project
• Maven：
  运行 mvn clean compile

---

3. Java 版本不兼容

Lombok 需要与 Java 版本兼容（通常支持 Java 8+）

验证步骤：

• 确认项目 JDK 版本 ≥8
• 在 pom.xml 或 build.gradle 中设置正确的 source 和 target 版本

---

4. 配置文件冲突

自定义 lombok.config 文件或第三方库可能干扰注解行为

解决步骤：

• 检查项目根目录是否存在 lombok.config，尝试暂时移除该文件
• 排除其他库（如 MapStruct）的注解处理器冲突

---