Spring Boot+Spring Data JPA使用Lombok时数据插入失败问题

可能原因 #

• Lombok注解不完整或错误：仅使用部分注解（如只加@Getter/@Setter却漏加构造相关注解），导致Spring Data JPA无法正确实例化实体或赋值属性；或者未使用@Data这类组合注解，遗漏了必要的方法。
• 构造方法缺失：Spring Data JPA要求实体类具备无参构造方法，若仅添加@AllArgsConstructor而未加@NoArgsConstructor，会导致JPA无法创建实体实例，最终插入的数据为空。
• 版本兼容性问题：Lombok版本与当前Spring Boot版本不匹配，导致注解处理器无法正常生成对应的getter/setter方法。
• IDE支持未配置：IDE未安装Lombok插件或未启用注解处理器，编译时没有生成Lombok注解对应的方法，运行时实体类实际上没有getter/setter。

解决方案 #

1. 修正Lombok注解配置
   确保实体类上添加完整的Lombok注解，推荐使用@Data（整合getter、setter、equals、hashCode、toString），同时补充无参和全参构造注解：

   @Entity
   @Data
   @NoArgsConstructor
   @AllArgsConstructor
   public class Quiz {
       @Id
       @GeneratedValue(strategy = GenerationType.IDENTITY)
       private Long id;
       private String title;
       // 其他业务属性
   }
   

2. 匹配Lombok与Spring Boot版本
   优先使用Spring Boot依赖管理中的Lombok版本，避免手动指定版本导致兼容问题。Maven依赖示例：

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

   Spring Boot 2.x与3.x对应的Lombok版本有差异，可参考官方依赖清单确认匹配版本。

3. 配置IDE的Lombok支持

   • IntelliJ IDEA：安装Lombok插件，然后进入Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors，勾选Enable annotation processing。
   • Eclipse：安装Lombok插件，确保项目的注解处理器已启用。

4. 验证编译结果
   编译项目后，查看target/classes目录下的Quiz.class文件，用javap -c Quiz.class命令检查字节码，确认getter、setter和构造方法已生成。

验证流程 #

重新编译并启动应用，调用插入接口时在Service层打印实体对象的属性值，确认属性已被正确赋值，再检查数据库是否有数据插入。

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