Spring Boot+Hibernate中主实体ID未关联更新至从实体关联列问题

问题根源 #

1. 双向关联未完整建立：你的一对多关联仅在EntityOne中声明了@OneToMany，但创建EntityTwo实例时，没有将EntityOne对象赋值给EntityTwo的entityOne属性。由于@OneToMany的mappedBy="entityOne"指定由多端（EntityTwo）维护关联关系，Hibernate需要多端的关联引用才能自动填充外键。
2. 外键字段配置冲突：EntityTwo中同时维护了独立的vendorId字段和@ManyToOne关联，且@JoinColumn设置了insertable=false, updatable=false，这会阻止Hibernate通过关联关系更新vendor_id字段，同时你又没有手动赋值vendorId，导致该字段为NULL。

解决方案 #

步骤1：修正EntityTwo实体类 #

推荐去掉冗余的vendorId字段，直接通过关联属性维护外键，简化实体结构：

@Entity
@Table(name = "entity2", schema = "schema")
public class EntityTwo {
   
   @Id
   @GeneratedValue(strategy=GenerationType.SEQUENCE, generator = "second_id_seq")
   @SequenceGenerator(sequenceName = "[schema].[second_id_seq]", name = "second_id_seq", allocationSize = 1)
   @Column(name = "id")
   private Integer id;

   private String name;
   
   @ManyToOne(fetch = FetchType.LAZY)
   // 移除insertable=false, updatable=false，允许Hibernate通过关联维护外键
   @JoinColumn(name = "vendor_id", referencedColumnName = "id", nullable = false)
   private EntityOne entityOne;

   // 生成Getter和Setter方法，重点是entityOne的Setter
}

如果业务上必须保留vendorId字段，可将其标记为只读，避免与关联字段冲突：

@Entity
@Table(name = "entity2", schema = "schema")
public class EntityTwo {
   
   @Id
   @GeneratedValue(strategy=GenerationType.SEQUENCE, generator = "second_id_seq")
   @SequenceGenerator(sequenceName = "[schema].[second_id_seq]", name = "second_id_seq", allocationSize = 1)
   @Column(name = "id")
   private Integer id;
   
   // 标记为只读，由关联字段负责插入更新
   @Column(name = "vendor_id", insertable = false, updatable = false)
   private Integer vendorId;

   private String name;
   
   @ManyToOne(fetch = FetchType.LAZY)
   @JoinColumn(name = "vendor_id", referencedColumnName = "id", nullable = false)
   private EntityOne entityOne;

   // Getter和Setter
}

步骤2：完善DAO层的关联建立逻辑 #

在创建EntityTwo实例时，必须将EntityOne对象赋值给EntityTwo的entityOne属性，建立完整的双向关联：

public EntityOne mapRequestToEntity(Request request) {
    EntityOne entityOne = new EntityOne();
    entityOne.setName(request.getName());
    List<EntityTwo> entityTwoList = new ArrayList<>();
    
    // 遍历请求中的EntityTwo数据，创建实例并建立关联
    for (RequestTwo reqTwo : request.getEntityTwoList()) {
        EntityTwo entityTwo = new EntityTwo();
        entityTwo.setName(reqTwo.getName());
        // 关键：将当前entityOne赋值给entityTwo的关联属性
        entityTwo.setEntityOne(entityOne);
        entityTwoList.add(entityTwo);
    }
    
    entityOne.setEntityTwo(entityTwoList);
    return save(entityOne);
}

原理说明 #

Hibernate中，双向一对多关联的维护端是多端（EntityTwo），因为数据库中外键存储在多端的表中。只有当多端持有主端的引用时，Hibernate才会在插入多端数据时自动填充外键字段。同时，@JoinColumn的insertable和updatable属性如果设置为false，会禁止Hibernate通过关联关系修改该字段，这也是之前外键为NULL的直接原因之一。

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