JPA实体关联异常：Cart与Item的cart_id、parent_id未正确填充

提供的Cart JSON数据 #

{"otherId": "12345","items": [{"children": [{"name": "1","description": "Nested Description","children": [{"name": "1.1","description": "Nested Description"},{"name": "1.2","description": "Another Nested Description"}]},{"name": "2","description": "Another Nested Description"}]}]}

实体类代码 #

Cart 实体 #

@Entity
@Table(name = "cart")
@Getter
@Setter
@NoArgsConstructor
public class Cart {
@Id
@GeneratedValue(strategy = GenerationType.UUID)
private String id;

@Column(name = "other_id")
private String otherId;

@OneToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REFRESH, CascadeType.DETACH}/*, mappedBy="cart"*/)
@JoinColumn(name = "cart_id", referencedColumnName = "id")
private List<Item> items;
}

Item 实体 #

@Entity
@Table(name = "item")
@Getter
@Setter
@NoArgsConstructor
public class Item {
@Id
@GeneratedValue(strategy = GenerationType.UUID)
private String id;

@ManyToOne(cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REFRESH, CascadeType.DETACH})
@JoinColumn(name = "parent_id",referencedColumnName ="id")
private Item parent;

@OneToMany(mappedBy = "parent", cascade = CascadeType.ALL,fetch = FetchType.LAZY)
private List<Item> children = new ArrayList<>();
}

问题现象 #

所有对象已成功保存，但仅一个Item的cart_id被填充，且所有Item的parent_id均未赋值。预期Hibernate应自动为子项填充关联ID，请求排查问题。

1. parent_id未赋值的原因 #

Hibernate不会自动维护双向关联的反向端：你只设置了Item的children集合（这是关联的反向端，因为@OneToMany(mappedBy="parent")指定由parent属性维护关联），但没有为每个子Item设置parent属性（关联的拥有端）。数据库中外键由关联的拥有端控制，这里Item.parent是parent_id外键的拥有端，必须显式为子Item设置parent引用，Hibernate才会填充parent_id。

解决方法：
构建Item层级结构时，遍历每个子Item，设置其parent属性指向父Item，示例代码：

Item parentItem = new Item();
Item childItem = new Item();
parentItem.getChildren().add(childItem);
childItem.setParent(parentItem); // 必须显式设置这一步

2. cart_id仅填充一个的原因 #

当前Cart的@OneToMany使用@JoinColumn，属于单向关联，Cart是cart_id外键的拥有端，但只有最顶层的Item被添加到Cart的items集合中，嵌套的子Item并未关联到Cart，因此只有顶层Item的cart_id被填充。

场景1：需要所有层级Item关联同一个Cart #

• 在Item实体中添加Cart关联属性：

@ManyToOne(cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REFRESH, CascadeType.DETACH})
@JoinColumn(name = "cart_id")
private Cart cart;

• 修改Cart的@OneToMany为双向关联：

@OneToMany(mappedBy = "cart", cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REFRESH, CascadeType.DETACH})
// 移除@JoinColumn，由Item.cart维护关联
private List<Item> items;

• 构建数据时，为所有层级的Item设置cart属性：

Cart cart = new Cart();
// 遍历所有Item（包括子项）
for(Item item : allItems) {
    item.setCart(cart);
}
cart.setItems(topLevelItems);

场景2：仅顶层Item关联Cart（子Item通过parent_id关联父项） #

当前配置本身没问题，但需确保只有顶层Item被加入Cart的items集合，且子Item的parent属性已按上述方法正确设置。

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