Hibernate Envers条件审计下ElementCollection变更未被记录问题

问题场景 #

我有一个包含枚举集合的实体类，映射代码如下：

@ElementCollection(targetClass = MyEnum.class)
private Set<MyEnum> theValues = new HashSet<>();

通过自定义Integrator实现了条件审计，提交时根据规则决定是否生成审计版本（即是否写入_AUD表）。目前遇到的问题：

• 提交1：创建实例，theValues={A,B,C}，生成审计版本，审计表记录值正确
• 提交2：修改theValues为{D,E}，标记为非审计版本，审计表无新增记录
• 提交3：修改实例其他属性，生成审计版本，审计表新增记录，但该版本的theValues仍为{A,B,C}，而非预期的{D,E}

环境 #

SpringBoot 3.5.0 + Hibernate Envers 6.6.15

原因分析 #

Envers默认追踪变更的逻辑是基于上一个审计版本，非审计版本的变更不会被写入Envers的内部快照存储。当后续生成审计版本时，Envers仅对比当前实体状态与上一个审计版本的差异，中间非审计版本的属性修改（比如元素集合的变更）会被忽略，导致审计版本中的属性值未同步。

解决方案 #

1. 调整Integrator实现，同步非审计版本的快照 #

在自定义Integrator中，即使决定不生成审计版本，也要更新Envers的实体快照，确保后续审计版本能基于最新状态对比：

// 在Integrator的事件处理方法（如onPostUpdate）中
AuditConfiguration auditConfig = AuditConfiguration.getFor(session.getSessionFactory());
AuditProcessManager processManager = auditConfig.getAuditProcessManager();
AuditProcess auditProcess = processManager.getAuditProcess(session);

// 即使不生成审计版本，也要更新实体快照
if (!shouldGenerateAuditVersion()) {
    auditProcess.updateEntitySnapshot(entity, entityId, session);
}

2. 自定义审计策略 #

实现AuditStrategy接口，重写变更对比逻辑，直接基于当前实体状态与上一个审计版本的状态生成审计记录，而非依赖中间变更：

public class CustomAuditStrategy extends DefaultAuditStrategy {
    @Override
    public void perform(
            Session session,
            String entityName,
            AuditConfiguration auditCfg,
            Serializable id,
            Object data,
            Object revision) {
        // 自定义逻辑：获取当前实体状态与上一个审计版本状态对比
        // 生成审计记录时使用最新的实体属性值
        super.perform(session, entityName, auditCfg, id, data, revision);
    }
}

然后在Spring Boot配置中指定该策略：

spring.jpa.properties.org.hibernate.envers.audit_strategy=com.yourpackage.CustomAuditStrategy

3. 备选方案：强制集合变更触发审计 #

如果业务允许，可在修改theValues时同步更新一个冗余的审计触发属性（如lastCollectionModified），确保集合变更时生成审计版本。但此方案可能不符合条件审计的核心需求，仅作为临时替代。

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