基于PostgreSQL触发器的Hibernate审计：关联实体修改无版本记录问题

针对你遇到的问题——仅修改未标注@AuditedEntity的关联实体（如RoleUser）时，无法触发audit_revision表的版本记录，以下是几个更优雅的实现方案，无需依赖hibernate-envers：

方案1：监听器中向上追溯关联的审计实体 #

在自定义的preInsert/preUpdate/preDelete监听器中，处理关联实体时主动追溯其关联的@AuditedEntity父实体（如User），若存在则触发版本记录创建，同时基于transactionId做同事务去重。

实现步骤： #

• 在监听器方法中，通过Hibernate的SessionFactory获取当前实体的元数据（PersistentClass），遍历其所有关联属性
• 检查关联属性对应的实体是否带有@AuditedEntity注解
• 若找到匹配的父实体，先查询当前transactionId是否已存在audit_revision记录，不存在则创建
• 示例代码片段：

@Override
public void onPreUpdate(PreUpdateEvent event) {
    Object entity = event.getEntity();
    // 若当前实体是RoleUser，追溯关联的User
    if (entity instanceof RoleUser) {
        RoleUser roleUser = (RoleUser) entity;
        User user = roleUser.getUser();
        if (user != null && user.getClass().isAnnotationPresent(AuditedEntity.class)) {
            String transactionId = getCurrentTransactionId();
            // 检查当前事务是否已生成revision记录
            if (!auditRevisionExists(transactionId)) {
                createAuditRevision(transactionId, user.getClass().getName(), "UPDATE");
            }
        }
    }
}

方案2：给关联实体添加父审计实体标记注解 #

定义一个自定义注解（如@AuditedParent），标注在关联实体上明确其对应的审计父实体，监听器直接通过注解识别并触发版本记录，避免盲目遍历关联。

实现步骤： #

• 定义注解：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface AuditedParent {
    Class<?> value();
}

• 在RoleUser上标注：@AuditedParent(User.class)
• 监听器中检查该注解，直接关联到父审计实体：

@Override
public void onPreUpdate(PreUpdateEvent event) {
    Class<?> entityClass = event.getEntity().getClass();
    AuditedParent auditedParent = entityClass.getAnnotation(AuditedParent.class);
    if (auditedParent != null && auditedParent.value().isAnnotationPresent(AuditedEntity.class)) {
        String transactionId = getCurrentTransactionId();
        if (!auditRevisionExists(transactionId)) {
            createAuditRevision(transactionId, auditedParent.value().getName(), "UPDATE");
        }
    }
}

方案3：事务提交前统一校验补全版本记录 #

注册Hibernate的TransactionEventListener，在事务提交前统一扫描当前事务中所有变更的实体，检查是否关联了@AuditedEntity实体，若未生成版本记录则补全。

实现步骤： #

• 实现TransactionEventListener：

public class AuditTransactionListener implements TransactionEventListener {
    @Override
    public void beforeCompletion(TransactionEvent event) {
        Session session = event.getSession();
        String transactionId = getCurrentTransactionId();
        // 检查当前事务是否已有revision记录
        if (auditRevisionExists(transactionId)) {
            return;
        }
        // 遍历事务中所有变更的实体
        Set<Object> dirtyEntities = session.getDirtyEntities();
        for (Object entity : dirtyEntities) {
            // 检查实体是否关联@AuditedEntity
            if (isAssociatedWithAuditedEntity(entity)) {
                createAuditRevision(transactionId, getAuditedParentClassName(entity), "UPDATE");
                break;
            }
        }
    }
}

• 通过SessionFactory注册该监听器，确保事务提交前触发校验。

实际项目经验分享 #

• 生产环境中通常结合方案1+方案3：监听器实时处理大部分场景，事务提交前的校验兜底，避免漏记录
• 核心原则：同一个事务内的所有变更对应一条audit_revision记录，所有细节由PostgreSQL触发器写入audit_revision_details，因此必须基于transactionId严格去重
• 性能优化：缓存实体的元数据（如哪些实体是@AuditedEntity、哪些关联了父审计实体），避免每次反射检查带来的开销

内容的提问来源于stack exchange，提问作者Mançaux Pierre-Alexandre