触发Hibernate Envers审计：List<BigDecimal>字段变更未被识别的问题

问题场景 #

实体代码如下：

@Entity
@Audited
class ValuesHolder(

    // other fields

    @Column(columnDefinition = "NUMERIC(18,6)[]", nullable = false)
    var values: List<BigDecimal?>,
)

对values字段做任何修改时，Hibernate Envers都无法识别变更，也不会生成审计记录。

原因 #

Hibernate Envers默认靠对象引用是否变化判断字段是否修改。对于List这类集合，要是只修改集合内部元素（增删改元素值）但没换集合本身的引用，Envers会判定这个字段没变更，不会触发审计。

另外你这里用List<BigDecimal?>搭配数据库数组类型（NUMERIC(18,6)[]），Hibernate会把它映射成基本类型数组的包装集合，这种场景下Envers的默认变更检测逻辑感知不到集合内部元素的变化。

解决方法 #

方法1：修改集合引用 #

每次修改集合元素后，重新创建新的集合对象替换原引用：

// 示例：修改元素后替换集合引用
holder.values = holder.values.toMutableList().apply {
    set(0, BigDecimal("100.00"))
}

这种方式简单直接，但需要在业务代码里手动处理集合更新逻辑。

方法2：改用@ElementCollection注解 #

把values字段改成@ElementCollection映射，让Hibernate把集合元素当作独立可审计对象：

@Entity
@Audited
class ValuesHolder(

    // other fields

    @ElementCollection
    @CollectionTable(name = "values_holder_values", joinColumns = [JoinColumn(name = "values_holder_id")])
    @Column(name = "value", precision = 18, scale = 6, nullable = false)
    var values: MutableList<BigDecimal?> = mutableListOf(),
)

这种配置下，Envers会自动跟踪集合元素的增删改，不用手动处理引用变更。但要注意，这种映射会生成一张关联表，和原来的数据库数组存储方式不同，需要考虑数据迁移的问题。

方法3：自定义审计监听器 #

如果必须保留数据库数组类型的存储方式，可以自定义Hibernate Envers监听器，手动检测集合内部元素变化：

1. 实现PostUpdateEventListener接口，在更新事件中对比集合元素内容
2. 检测到元素变化时，手动触发Envers的审计逻辑
   这种方法复杂度较高，适合必须维持原有存储结构的场景。

是否需要手动处理？ #

• 用方法1：需要在业务代码中手动替换集合引用
• 用方法2：无需额外手动处理，Envers自动跟踪变更
• 用方法3：需要手动编写自定义监听器的逻辑

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