Hibernate Envers不审计带@Column的@ElementCollection属性问题

Hibernate核心与Hibernate Envers对@ElementCollection字段上直接标注的@Column注解解析逻辑不一致：

• Hibernate核心ORM在解析主业务表映射时，可以正确识别字段层级的@Column(columnDefinition = "TEXT")是作用于集合表的字符串元素列，因此主业务的集合表可以正常生成，且字符串列类型为TEXT。
• 旧版本Hibernate Envers在构建审计表元数据时存在逻辑缺陷：当检测到@ElementCollection标记的字段上直接带有配置了columnDefinition属性的@Column注解时，会误将该属性判定为实体主表的普通基本类型字段，而非需要生成独立审计表的集合属性，最终跳过对应集合审计表的创建流程，这也是移除@Column注解后审计表能正常生成的根本原因。

根据你使用的Hibernate版本，选择以下任意一种方案即可：

• 方案1：明确声明集合表配置，消除注解解析歧义
  保留@Column的columnDefinition配置，同时显式添加@CollectionTable注解指定集合表信息，让Envers可以正确识别这是集合类型的元素列配置，示例代码如下：

  @Audited
  @Entity
  public class SomeObject {
  
     @Id
     @GeneratedValue(strategy = GenerationType.TABLE)
     protected long id; 
      
     @LazyCollection(LazyCollectionOption.FALSE)
     @ElementCollection
     // 显式声明集合表，消除Envers的解析歧义
     @CollectionTable(name = "some_object_text_attrs")
     @Column(columnDefinition = "TEXT")
     private List<String> someTextAttributes; 
  }
  

• 方案2：通过类型注解指定列类型，绕开columnDefinition配置
  不使用@Column的columnDefinition属性，直接通过Hibernate提供的类型注解指定字符串映射为TEXT类型，Envers对这类注解的解析不存在兼容性问题：
  • Hibernate 5.x 版本写法：

    @Audited
    @Entity
    public class SomeObject {
    
       @Id
       @GeneratedValue(strategy = GenerationType.TABLE)
       protected long id; 
        
       @LazyCollection(LazyCollectionOption.FALSE)
       @ElementCollection
       // 直接指定类型为text，无需配置columnDefinition
       @Type(type = "text")
       private List<String> someTextAttributes; 
    }
    

  • Hibernate 6.x 版本写法：

    @Audited
    @Entity
    public class SomeObject {
    
       @Id
       @GeneratedValue(strategy = GenerationType.TABLE)
       protected long id; 
        
       @LazyCollection(LazyCollectionOption.FALSE)
       @ElementCollection
       // 指定JDBC类型为长文本，对应数据库TEXT类型
       @JdbcTypeCode(SqlTypes.LONGVARCHAR)
       private List<String> someTextAttributes; 
    }
    

• 方案3：升级Hibernate版本
  该元数据解析bug在Hibernate 5.4.30.Final、5.6.0.Final及之后的正式版本中已经被修复，升级到对应修复版本后，即使直接在@ElementCollection字段上标注@Column(columnDefinition = "TEXT")，也可以正常生成集合对应的审计表。

配置完成后启动应用，可以在DDL执行日志中看到主集合表对应的_REV后缀审计表正常生成，且表内的字符串列同样为TEXT类型，完全满足长文本存储需求。

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