JPA+JSONB集合映射时Hibernate Schema校验失败问题咨询

问题本质来自注解语义与业务目标的错配：

• @ElementCollection的原生设计目标是将非实体类的集合元素存储在独立关联中间表中，必然触发Hibernate对中间表的Schema校验、表生成逻辑，与“将集合直接存储在单表JSONB列”的需求完全冲突。只要该注解存在，无论叠加多少列映射、转换器配置，Hibernate都会按照关联表规则执行校验，必然抛出表不存在的异常。
• 早期使用*@Type*映射触发的元模型报错，源于Hibernate 6+版本的元模型推断逻辑：当字段Java类型为Set，但映射实现被识别为单值类型时，就会抛出「预期SingularAttribute、实际碰到SetAttribute」的类型不匹配，该问题与序列化逻辑本身无关。

1. 清除语义错配的注解配置 #

• 移除字段上的*@ElementCollection*注解，从根源上切断Hibernate对关联中间表的校验逻辑
• 移除原有错误的*@Convert配置：JPA原生@Convert*仅支持单值字段映射，无法直接作用在Set这类集合类型字段上
  基础实体结构修正（修正原代码的类名拼写笔误）：

@Entity
@Table(name = "my_class")
public class Class extends BaseEntity<Long> {

    @Column(name = "schedules", nullable = false, columnDefinition = "jsonb")
    private Set<ClassSchedule> schedules;

}

2. 基于Hibernate集合类型体系实现自定义映射 #

针对元模型类型不匹配问题，不要使用普通UserType做全字段单值映射，需匹配Hibernate的集合类型规则：

• 自定义Set类型的映射实现需继承Hibernate提供的集合类型抽象基类，让元模型生成器自动识别该字段为SetAttribute类型，从根源上解决单值/集合属性的类型不匹配报错
• 在自定义映射逻辑中完成Set<ClassSchedule>与JSONB结构的双向转换：读取数据库时将JSONB列的数组结构反序列化为Set，写入时将Set序列化为合规JSON数组存入列，全程不涉及任何跨表关联逻辑
• 显式指定字段对应的JDBC类型为PostgreSQL JSONB，避免Hibernate将其识别为普通字符串类型

3. 启动校验逻辑适配 #

完成上述配置后，Hibernate的Schema校验逻辑仅会针对主表上的schedules列做类型匹配检查，不会再尝试寻找不存在的关联中间表。既不需要关闭Schema校验开关，也能正常生成匹配字段类型的元模型。

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