Hibernate @MappedSuperclass下持久化对象Map报参照完整性约束错误

核心错误是在@MappedSuperclass标注的映射超类中，给@OneToMany关联硬编码了固定的关联表名，完全不符合@MappedSuperclass的映射逻辑：

• @MappedSuperclass本身不是可持久化实体，不会生成独立数据表，它定义的所有字段、关联规则会被每个子类单独继承，每个子类持有完全独立的一套关联映射。
• 你给两个子类的Map关联都指定了同一个关联表名EmbeddedObjectsMap_TestObject_mapping，Hibernate初始化映射元数据时，后解析的实体会覆盖先解析实体的外键定义——也就是hibernate.cfg.xml里哪个子类的mapping配置写在最后，这张公共关联表的外键就会指向哪个子类的主键表。这就是为什么调换mapping顺序后，报错的实体会跟着变：一张表的外键只能指向一个主表，根本不可能同时满足两个子类的关联约束，不管怎么调顺序，总有一个子类插入数据时触发外键错误。

根据业务场景二选一即可：

方案1：每个子类使用独立关联表（最符合@MappedSuperclass的设计初衷） #

不要在超类上写死关联表配置，把关联表定义下沉到每个子类，给每个子类分配专属的关联表名：

1. 删掉超类embeddedObjectsMap属性上的@JoinTable注解，只保留@OneToMany、@Fetch、@MapKeyColumn这类通用配置
2. 在SubClass1中重写getEmbeddedObjectsMap方法，加上专属的@JoinTable配置，指定独立表名，示例：

@Entity
@org.hibernate.annotations.Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
public class SubClass1 extends SuperClass {
    public SubClass1() {}

    @Override
    @OneToMany(cascade = CascadeType.ALL)
    @Fetch(FetchMode.JOIN)
    @JoinTable(
            name = "subclass1_embedded_map",
            joinColumns = {@JoinColumn(name = "super_class_id", referencedColumnName = "SuperClassID")},
            inverseJoinColumns = {@JoinColumn(name = "embedded_obj_id", referencedColumnName = "embeddedObjectID")}
    )
    @MapKeyColumn
    public Map<Long, EmbeddedObject> getEmbeddedObjectsMap() {
        return super.getEmbeddedObjectsMap();
    }
}

3. SubClass2做同样的重写，把@JoinTable的name换成专属表名比如subclass2_embedded_map即可。
   这种方式下每个子类的关联数据存在独立表中，外键指向对应子类的主键表，完全不会出现映射冲突。

方案2：改用JOINED继承策略（适合需要多态查询的场景） #

如果业务上需要把两个子类的关联数据存在同一张关联表、需要支持跨子类的多态查询，就不要用@MappedSuperclass，改为实体继承的JOINED策略：

1. 去掉SuperClass上的@MappedSuperclass注解，加上@Entity和@Inheritance(strategy = InheritanceType.JOINED)注解
2. 超类上原有的@JoinTable配置完全保留不用修改
3. 两个子类不需要重写关联配置，只需要在类上加@Entity和@PrimaryKeyJoinColumn(name = "SuperClassID")注解即可
   这种模式下超类会生成独立的主键表，所有子类的主键都关联超类表的主键，公共关联表的外键直接指向超类表的主键，不会出现外键指向错误，同时支持多态关联查询。

后续如果遇到Hibernate映射行为和配置文件中实体声明顺序强相关的问题，优先检查是否存在同名数据表、同名关联被后加载的映射元数据覆盖的问题，这类问题90%都是重复映射定义导致的。

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