Hibernate映射超类中OneToMany关联触发非空约束异常解决方案

这个问题的核心原因是：当使用@MappedSuperclass时，子类B和C会各自继承父类A的@OneToMany关联配置，但Hibernate错误地将两个子类的外键列（b_id、c_id）都放到了同一个关联表listcontents中，并且默认给这两个列加上了非空约束。这就导致保存B的列表时c_id为空，保存C的列表时b_id为空，直接触发数据库的非空约束异常。

下面给出两种满足你需求的解决方案（子类无需编写任何额外代码，仅修改A类即可）：

方案一：将父类A改为实体类并使用JOINED继承策略（推荐） #

这是最规范的解决方式，通过JPA的继承映射让父类A成为实体，子类B、C基于JOINED策略关联父类表，这样关联表只会生成一个指向父类A主键的外键列，避免多外键冲突。

修改后的A类代码如下：

@Entity
@Inheritance(strategy = InheritanceType.JOINED) // 指定JOINED继承策略
abstract class A {
    @Id
    @GeneratedValue
    public long id;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinTable(name = "listcontents")
    public List<D> list1;
}

原理说明： #

• 改成@Entity后，Hibernate会为A生成独立的表，B和C的表会通过主键关联A的表（JOINED策略的特性）。
• 关联表listcontents只会生成一个a_id外键列，指向A表的主键，不管是B还是C的实例，都会通过A的主键与D建立关联，不会再出现b_id和c_id同时存在的情况，自然也就解决了非空约束问题。

方案二：保留@MappedSuperclass，允许关联表中外键列为空 #

如果你不想改变@MappedSuperclass的结构，可以手动修改@JoinTable的外键配置，让关联表的外键列允许为空。这种方式虽然能解决异常，但数据结构会有冗余（每条关联记录总有一个外键列是null），仅适合无法修改父类实体类型的场景。

修改后的A类代码：

@MappedSuperclass
abstract class A {
    @Id
    @GeneratedValue
    public long id;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinTable(
        name = "listcontents",
        joinColumns = @JoinColumn(name = "parent_id", nullable = true),
        inverseJoinColumns = @JoinColumn(name = "d_id")
    )
    public List<D> list1;
}

原理说明： #

• 这里显式指定关联表的外键列为parent_id，并设置nullable = true，Hibernate就不会为每个子类生成单独的外键列，而是统一使用parent_id关联所有子类的实例，实际保存时只会填充对应子类的ID，空值不会触发约束异常。

需要注意的是，第二种方案可能会带来数据一致性的潜在风险，因此更推荐第一种JOINED继承的方案。

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