Hibernate中@PreUpdate与@PrePersist注解失效问题排查

核心原因排查 #

你的问题大概率和@Data注解生成的equals/hashCode方法有关，或是更新逻辑中实体未被Hibernate上下文托管，导致@PreUpdate未触发。

1. 修复@Data注解的字段覆盖问题 #

@Data默认会基于所有字段生成equals和hashCode方法，其中包含lastUpdated字段时，可能导致Hibernate误判实体未发生变更，跳过@PreUpdate触发。

解决方式：
手动通过@EqualsAndHashCode排除lastUpdated字段，避免其干扰实体变更判断：

@Data
@Entity
@EqualsAndHashCode(exclude = "lastUpdated")
public class DomainEntity {
    @Id
    @Include
    private Integer id;
    private String name;

    @Temporal(TIMESTAMP)
    private Date lastUpdated;

    @PrePersist
    @PreUpdate
    private void onUpdate() {
        lastUpdated = new Date();
    }
}

2. 优化更新逻辑，确保实体处于托管状态 #

当前更新逻辑是创建新实体并设置ID后保存，新实体处于游离状态，Hibernate执行merge时若检测不到字段变更，不会触发更新。

优化方案：
直接修改从数据库查询到的托管状态实体：

Optional<DomainEntity> domainOptionalOld = domainRepository.findByName(domainEntity.getName());
domainOptionalOld.ifPresent(d -> {
    // 直接修改托管的实体对象
    d.setName(domainEntity.getName());
    // 其他字段更新操作...
    domainRepository.save(d); // 此时Hibernate会检测到变更，触发@PreUpdate
});

3. 调整方法访问修饰符（可选） #

虽然Hibernate可通过反射访问private方法，但将onUpdate()改为protected或public，能避免部分版本兼容性问题：

@PrePersist
@PreUpdate
protected void onUpdate() {
    lastUpdated = new Date();
}

4. 检查字段更新权限 #

确认失效实体的lastUpdated字段未被@Column(updatable = false)等注解设置为不可更新，该配置会直接阻止Hibernate修改此字段。

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