Hibernate：已弃用AbstractPreDatabaseOperationEvent.getEntity()的Hibernate6替代方案

针对你需要在实体更新前执行复杂校验并获取新旧状态的场景，Hibernate 6推荐以下方案：

1. 基于PreUpdateEventListener的兼容实现 #

Hibernate 6中PreUpdateEventListener仍为有效扩展点，且PreUpdateEvent自身提供了非弃用的实体与状态访问方法：

• 获取当前实体：调用event.getEntity()，该方法在Hibernate 6中已替代父类的弃用方法，可直接安全使用
• 获取新旧状态：通过event.getOldState()（旧值数组）和event.getState()（新值数组）获取属性值，配合event.getPersister().getPropertyNames()可映射到具体属性名

示例代码：

public class EntityUpdateValidator implements PreUpdateEventListener {
    @Override
    public boolean onPreUpdate(PreUpdateEvent event) {
        Object entity = event.getEntity();
        if (!(entity instanceof TargetEntity)) {
            return false;
        }
        
        TargetEntity target = (TargetEntity) entity;
        String[] propNames = event.getPersister().getPropertyNames();
        Object[] oldValues = event.getOldState();
        Object[] newValues = event.getState();
        
        // 遍历属性对比新旧值，执行复杂校验
        for (int i = 0; i < propNames.length; i++) {
            String prop = propNames[i];
            if ("criticalField".equals(prop)) {
                if (!validateFieldChange(oldValues[i], newValues[i])) {
                    throw new BusinessValidationException("字段变更不符合规则");
                }
            }
        }
        return false; // 返回false允许更新，true则拦截操作
    }
    
    private boolean validateFieldChange(Object oldVal, Object newVal) {
        // 自定义校验逻辑
        return oldVal != null && newVal != null && /* 校验条件 */;
    }
}

2. 监听器注册方式 #

在Hibernate 6中，通过SessionFactoryBuilder注册监听器：

SessionFactory sessionFactory = new MetadataSources(serviceRegistry)
        .addAnnotatedClass(TargetEntity.class)
        .buildMetadata()
        .getSessionFactoryBuilder()
        .applyListener(EventType.PRE_UPDATE, new EntityUpdateValidator())
        .build();

关键说明 #

• JPA的@PreUpdate注解确实无法直接获取旧状态，因此Hibernate原生的事件监听器仍是此类复杂校验场景的最优选择
• PreUpdateEvent提供的状态数组是Hibernate内部维护的快照，性能远高于手动查询实体快照的方式

内容的提问来源于stack exchange，提问作者Alex L.