如何使用Lombok创建适配Hibernate的安全JPA实体

核心思路 #

不需要依赖有隐患的@Data注解，通过Lombok单个注解的灵活配置，完全可以覆盖所有需求，同时规避Hibernate协同的常见坑，绝大多数场景不需要手写大量样板代码，只有极少数版本兼容或特殊业务逻辑的场景需要少量手动补充。

完整注解组合与对应需求匹配 #

我们可以把需要的能力和Lombok注解一一对应，不用额外手写getter、setter、构造器：

• 无参构造器要求：使用@NoArgsConstructor(access = AccessLevel.PROTECTED)生成给Hibernate反射用的无参构造。设置为protected权限，既不影响Hibernate通过反射实例化对象，又能避免业务代码随意实例化无状态的空实体。
• 排除自动管理字段的全参构造器：使用@AllArgsConstructor(exclude = {"id", "updatedTime"})。Lombok 1.18.2及以上版本支持exclude参数，生成的构造器会自动排除不想作为参数的id、updatedTime两个字段，刚好匹配“除自动管理字段外全字段可初始化”的次级构造器，不用手动写20个字段的参数列表。
• 无setter的自动管理字段：类级别加@Getter为所有字段生成getter方法；类级别加@Setter为所有字段默认生成setter，再在id、updatedTime两个字段上单独标注@Setter(AccessLevel.NONE)，覆盖类级别的配置，这两个字段就不会生成public的setter，完全符合“希望Hibernate通过反射直接赋值、不对外暴露修改入口”的需求。
• 安全的equals/hashCode实现：使用@EqualsAndHashCode(onlyExplicitlyIncluded = true, callSuper = false)。关闭Lombok默认的“所有字段参与计算”逻辑，只在指定的唯一标识字段上标注@EqualsAndHashCode.Include（通常优先选择业务上稳定的自然唯一标识，没有的话再用代理主键id），让equals和hashCode的计算完全基于这个固定标识，从根源避免JPA实体常见的比对不稳定问题（比如未持久化时id为null、持久化后id赋值导致同一对象hashCode变化），也不会因为比对操作触发懒加载字段的初始化。
• 安全的toString实现：使用@ToString(of = {"id", "updatedTime"})。自定义toString的输出范围，只输出主键和更新时间，避免默认实现遍历所有字段时，触发懒加载关联对象的初始化，甚至在事务外抛出懒加载异常的隐蔽问题。

最终代码示例 #

@Entity
@Getter
@Setter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@AllArgsConstructor(exclude = {"id", "updatedTime"})
@EqualsAndHashCode(onlyExplicitlyIncluded = true, callSuper = false)
@ToString(of = {"id", "updatedTime"})
public class MyEntity {
  @Id
  @GeneratedValue(strategy = GenerationType.AUTO)
  @Setter(AccessLevel.NONE)
  @EqualsAndHashCode.Include
  private Long id;

  @UpdateTimestamp
  @Setter(AccessLevel.NONE)
  private LocalDateTime updatedTime;

  // 其余18-20个业务字段不需要加任何Lombok注解
  private String bizField1;
  private String bizField2;
  // ... 省略其余字段
}

关于是否需要手动写代码的说明 #

绝大多数场景完全不需要手动实现getter、setter、equals、hashCode、toString这些样板代码，只有两类情况需要少量手动补充：

• 如果使用的Lombok版本低于1.18.2，@AllArgsConstructor还不支持exclude参数，那对应的次级构造器可以借助IDE的生成功能快速手写，其余的getter、setter、比对、字符串方法依然可以靠Lombok生成，不需要全量手写。
• 如果实体在初始化时需要做默认值填充、参数校验这类复杂逻辑，只需要在对应的构造器里补充几行业务逻辑即可，依然比从零写所有样板代码的工作量低很多。

常见认知澄清 #

• Hibernate实例化、加载、持久化实体的过程，本身就不依赖setter方法，只要能通过反射拿到字段权限，哪怕是private字段也可以正常赋值，不设置id、updatedTime的setter完全不会影响ORM流程的正常运行。
• 绝对不要直接在JPA实体上用@Data注解：它默认会为所有字段生成setter（包括主键和自动更新的时间戳），同时生成基于全字段的equals、hashCode、toString，既会暴露自动管理字段的修改入口，又会触发前面提到的懒加载、比对不稳定的隐蔽问题。

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