使用Hibernate和Spring持久化键为实体的Map

你的代码存在几个明显错误，导致触发IllegalStateException，下面逐一说明并给出修正方案：

核心问题点 #

• @OneToMany与@ElementCollection冲突：这两个注解不能同时使用。@OneToMany用于映射实体间的一对多关联（Map的值必须是实体类型），而@ElementCollection用于映射值类型集合（如Integer、String或Embeddable类）。你的场景是键为实体、值为Integer，应该用@ElementCollection。
• @MapKeyClass使用错误：@MapKeyClass是针对值类型的键使用的（比如键是String、Integer），当键是实体类型时，需要用@MapKeyJoinColumn来指定关联实体的外键列。
• 泛型与注解类名不匹配：代码中Map泛型是MyEntityClass，但@MapKeyClass写的是MyEntity.class，需统一类名（以下示例统一为MyEntity）。
• final字段限制：Hibernate需要通过反射实例化实体并操作字段，final字段若未初始化会导致实例化失败，建议移除final或在构造方法中初始化Map。

修正后的代码 #

@Entity
public class SecondClass extends DomainObject {
    
    @Id
    @GeneratedValue
    private Long id;

    @ElementCollection(fetch = FetchType.EAGER)
    // 指定关联表中指向MyEntity的外键列名
    @MapKeyJoinColumn(name = "my_entity_id")
    // 自定义集合关联表的名称和关联当前实体的外键列（可选，Hibernate会自动生成默认值）
    @CollectionTable(name = "second_class_my_map", joinColumns = @JoinColumn(name = "second_class_id"))
    // 初始化Map并移除final，确保Hibernate正常操作
    private Map<MyEntity, Integer> myMap = new HashMap<>();

    // Hibernate要求的无参构造方法
    public SecondClass() {
    }

    // 按需添加getter、setter和其他构造方法
}

关键注解说明 #

• @ElementCollection：声明该集合是值类型集合，Hibernate会为其创建一张单独的关联表存储键值对。
• @MapKeyJoinColumn：指定Map的键是MyEntity实体，关联表中通过my_entity_id列关联MyEntity的主键。
• @CollectionTable：自定义关联表的名称（second_class_my_map）和关联SecondClass的外键列（second_class_id），如果不指定，Hibernate会自动生成表名和外键列。

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