Hibernate OneToMany关联配置正确但子实体未持久化问题求助

• 级联持久化配置缺失
  你的@OneToMany注解没有配置级联属性，JPA默认不会自动持久化关联的子实体。需要修改主实体的childList字段注解，添加级联规则：

@OneToMany(fetch = LAZY, mappedBy = "mainEntity", cascade = CascadeType.PERSIST)
// 如果需要更新、删除等操作也同步关联子实体，可以配置为cascade = CascadeType.ALL

如果你的业务逻辑是先保存主实体，再添加子实体，也可以选择配置cascade = CascadeType.MERGE，保存主实体的时候调用merge方法即可。

• 添加子实体的方法存在逻辑错误
  你的addChildToList方法里，错误调用了Set集合的setUserId方法，实际你需要给入参的子实体赋值userId：

public void addChildToList(final ChildEntity child) {
    child.setMainEntity(this);
    // 原代码错误：childList.setUserId(this.getUserId()); 改为下面这行
    child.setUserId(this.getUserId());
    this.childList.add(child);
}

子实体的userId是主键字段，非空且不可更新，如果你没有给该字段赋值，就算开启级联也无法插入子表数据。

• 复合主键配置缺失
  你在主实体和子实体中都使用了两个@Id注解声明复合主键，但没有配置对应的主键类。JPA要求复合主键必须搭配@IdClass或者@EmbeddedId使用，否则Hibernate无法正确识别实体的主键规则，会导致持久化异常。
  以主实体为例，你需要先定义主键类：

public class MainEntityId implements Serializable {
    private String id;
    private String userId;
    // 补充全参构造器、equals、hashCode方法
}

然后在主实体类上添加注解：

@IdClass(MainEntityId.class)

子实体同理也需要配置对应的复合主键类。

• 实体语法错误修复

1. 子实体的CUSTOM_ID字段注解写法错误，缺少length属性名：

// 原错误写法：@Column(name = "CUSTOM_ID", 32)
@Column(name = "CUSTOM_ID", length = 32)
private String customId;

2. 你贴出的构建子实体的代码中subjectId("456)缺少结束引号，确认实际代码中已经修正该语法问题。

• 确认持久化调用逻辑
  你在添加完子实体后，必须调用持久化接口保存主实体，比如调用entityManager.persist(mainEntity)或者对应的DAO层save方法，才会触发级联持久化操作。如果仅在内存中给集合添加元素而不执行保存操作，不会产生任何数据库写入行为。

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