根本原因是Lombok插件未安装或未启用,需在IDEA中安装插件、启用注解处理,并确保Maven中正确配置annotationProcessor路径及版本对齐。

IDEA里没看到Lombok图标,@Data不生效怎么办
根本原因是插件没装或没启用,不是依赖加了就行。Lombok注解的编译期处理依赖IDE的额外支持,JDK本身不认@Data这类注解。
实操步骤:
- 打开 Settings → Plugins,搜索
Lombok,安装并重启IDEA - 进 Settings → Build → Compiler → Annotation Processors,勾选
Enable annotation processing - 确认项目用的是JDK 8–17(Lombok 1.18.30+ 支持 JDK 21,但部分旧版本在 JDK 21 下会静默失效)
- 如果用了 Maven,检查
pom.xml中lombok依赖 scope 是provided,否则可能干扰编译类路径
Maven中lombok依赖加了却报cannot find symbol
常见于编译时找不到生成的 getter/setter 方法,本质是编译器没加载 Lombok 的注解处理器。
关键点:
立即学习“Java免费学习笔记(深入)”;
- 必须显式声明
annotationProcessor(Maven 3.8.1+ 默认不传递compile依赖里的providedjar) -
lombok版本要和 IDE 插件版本对齐(比如 IDEA 插件 1.18.30 对应 lombok 1.18.30,混用高版本插件+低版本依赖常导致@Builder不生成代码) - 示例配置(注意
annotationProcessor块不能省):
<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version> <scope>provided</scope> </dependency>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<annotationProcessorPaths>
<path>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
</path>
</annotationProcessorPaths>
</configuration>
</plugin>
为什么@RequiredArgsConstructor生成的构造函数总报错
不是注解写错了,而是它只对 final 或 @NonNull 字段生效,其他字段被忽略——这点容易被误以为“没生成”。
典型陷阱:
- 字段写了
private String name;(非 final,无注解),@RequiredArgsConstructor完全不理会它 - 字段写了
private final List<String> tags = new ArrayList<>();,但构造函数仍要求传参——因为 Lombok 默认不跳过已初始化的 final 字段(除非加@RequiredArgsConstructor(onConstructor_ = @__(@Deprecated))这种绕过方式,但不推荐) - 更安全的做法:明确用
@AllArgsConstructor或手写构造器,避免依赖隐式行为
Spring Boot项目里@Data和@ToString引发循环引用问题
实体类之间双向关联(比如 User 持有 List<Order>,Order 又持有 User)时,@Data 自动生成的 toString() 会无限递归,直接 StackOverflowError。
解决逻辑很直接:
- 禁用自动生成:
@Data(exclude = "orders")或拆成@Getter @Setter @EqualsAndHashCode,手动控制 - 用
@ToString.Exclude标记字段(比 exclude 参数更清晰) - 别信“加个
@ToString(callSuper = false)就行”——父类没字段也救不了循环引用 - 尤其注意 Lombok 1.18.28+ 对
@ToString增加了exclude属性,但老版本不支持,得升级
Build → Compile 看是否真生成了方法,而不是只靠编辑器提示。










