Hibernate中两个@OneToMany列表存同表引发非空约束异常的原因与解决

问题原因 #

这个问题我之前也碰到过，本质是Hibernate处理@MappedSuperclass中多个@OneToMany关联时的默认表结构设计，和PostgreSQL的非空约束规则冲突导致的：

• 当你在@MappedSuperclass抽象类A中定义了两个@OneToMany关联（list1和list2），子类B作为@Entity被持久化时，Hibernate默认会将这两个关联映射到同一张连接表（也就是你看到的b_c）。
• 这张连接表会生成三个列：b_id（关联B的主键）、list1_id（关联C的主键，对应list1）、list2_id（关联C的主键，对应list2）。Hibernate默认会给list1_id和list2_id加上非空约束，因为它认为每个关联条目都应该对应其中一个列表。
• 但当你只给list1或list2中的一个添加元素时，另一个列的值就会是NULL，直接触发PostgreSQL的非空约束检查，抛出你看到的PSQLException。

另外你提到改用Set无效，是因为集合类型只影响内存中数据的存储方式，不会改变Hibernate生成数据库表结构的逻辑，所以问题依然存在。

解决方案 #

这里提供两种可行的解决思路，你可以根据业务需求选择：

方案1：为每个关联单独创建连接表（推荐）

通过@JoinTable注解，显式为每个@OneToMany关联指定独立的连接表，避免两个共享同一张表导致的冲突。修改抽象类A的代码如下：

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

    @OneToMany(cascade = CascadeType.ALL)
    @JoinTable(
        name = "b_list1_c",
        joinColumns = @JoinColumn(name = "b_id"),
        inverseJoinColumns = @JoinColumn(name = "c_id")
    )
    public List<C> list1;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinTable(
        name = "b_list2_c",
        joinColumns = @JoinColumn(name = "b_id"),
        inverseJoinColumns = @JoinColumn(name = "c_id")
    )
    public List<C> list2;
}

这样Hibernate会生成两张独立的连接表b_list1_c和b_list2_c，每张表只维护B和C的一组关联关系，自然不会出现null值违反约束的问题。

方案2：允许连接表中外键列为NULL

如果你坚持要使用同一张连接表，可以通过@JoinColumn显式设置外键列允许为null，覆盖Hibernate的默认非空约束。修改代码如下：

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

    @OneToMany(cascade = CascadeType.ALL)
    @JoinColumn(name = "list1_id", nullable = true)
    public List<C> list1;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinColumn(name = "list2_id", nullable = true)
    public List<C> list2;
}

这种方式下，b_c表的list1_id和list2_id都会被设置为允许null值，当你只填充其中一个列表时，另一个列的null值就不会触发约束异常。不过这种设计会导致连接表中存在大量null值，从数据库设计的角度来看不够规范，所以更推荐方案1。

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