在Hibernate同事务中通过PostDeleteEventListener实现软删除归档

1. 替换为PreDeleteEventListener实现 #

PostDeleteEvent触发时，原实体已被标记为删除并从Session中移除，此时在同一Session内保存归档实体的操作会因为事务上下文的限制无法同步到数据库。换成PreDeleteEventListener可以解决这个问题：

• 触发PreDelete事件时，原实体仍在Session中，能完整读取所有属性值
• 先创建归档实体并保存到当前Session，无需手动flush
• 返回false让Hibernate继续执行原实体的删除操作，事务提交时，归档插入和原实体删除会被一起同步到数据库

示例代码：

public class ArchivePreDeleteListener implements PreDeleteEventListener {
    @Override
    public boolean onPreDelete(PreDeleteEvent event) {
        Object entity = event.getEntity();
        if (entity instanceof YourEntity) {
            YourEntity original = (YourEntity) entity;
            // 构建归档实体并复制属性
            ArchivedEntity archive = new ArchivedEntity();
            archive.setId(original.getId());
            archive.setName(original.getName());
            // 复制其他业务属性...
            
            // 将归档实体加入当前Session
            event.getSession().save(archive);
        }
        // 返回false，允许Hibernate继续执行删除逻辑
        return false;
    }
}

2. 绕开Hibernate事件循环的原生JDBC操作 #

如果必须使用PostDeleteEventListener，可以直接通过底层JDBC连接执行归档插入，绕开Hibernate的Session事件监听机制，避免循环触发：

• 从当前Session获取JDBC连接，操作会处于同一事务上下文
• 用原生SQL插入归档数据，不会触发任何Hibernate事件监听器

示例代码：

public class ArchivePostDeleteListener implements PostDeleteEventListener {
    @Override
    public void onPostDelete(PostDeleteEvent event) {
        Object entity = event.getEntity();
        if (entity instanceof YourEntity) {
            YourEntity original = (YourEntity) entity;
            event.getSession().doWork(connection -> {
                try (PreparedStatement stmt = connection.prepareStatement(
                    "INSERT INTO archived_entity (id, name, create_time) VALUES (?, ?, ?)"
                )) {
                    stmt.setLong(1, original.getId());
                    stmt.setString(2, original.getName());
                    stmt.setTimestamp(3, original.getCreateTime());
                    stmt.executeUpdate();
                } catch (SQLException e) {
                    // 抛出运行时异常触发事务回滚
                    throw new RuntimeException("归档操作失败", e);
                }
            });
        }
    }

    @Override
    public boolean requiresPostCommitHanding(EntityPersister persister) {
        return false;
    }
}

关键注意事项 #

• 所有操作必须在同一事务内执行，确保归档和删除操作要么同时成功，要么同时回滚
• 使用PreDeleteEventListener时，不要返回true，否则会阻断原实体的删除流程
• 原生JDBC操作要做好异常处理，确保异常能触发事务回滚

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