Spring Data JPA无法保存子表记录问题求助

核心问题 #

你遇到的Child表未插入数据的原因有两点：

1. 复合主键中关联实体的持久化顺序冲突：Child的复合主键ChildPK直接关联了Parent实体，但Parent的ID是在save操作时才生成的，此时Child的主键无法获取有效Parent ID，导致JPA无法完成Child的插入。
2. 双向关联未正确维护：@OneToMany的mappedBy指定Child是关联维护端，但你创建数据时仅设置了Parent到Child的关联，未同步Child到Parent的绑定，JPA的级联操作无法触发。

具体修复步骤 #

1. 修改ChildPK，用基本类型存储Parent ID #

将复合主键中的Parent关联改为存储Parent的ID（Integer类型），避免关联实体在主键中的持久化冲突：

@Builder
@AllArgsConstructor
@NoArgsConstructor
@Getter
@Setter
@Embeddable
public class ChildPK implements Serializable {
    private static final long serialVersionUID = -3512694928135551826L;
    
    @Column(name = "id", nullable = false)
    private Integer parentId;

    @Column(name = "some_column", nullable = false, length = 10)
    private String someColumn;
}

2. 调整Child类，新增Parent关联并维护双向绑定 #

在Child类中新增@ManyToOne关联Parent，同时添加方法确保双向关联同步：

@Getter
@Setter
@Entity
@Table(name = "child", schema = "min_max")
@AllArgsConstructor
public class Child {
    @EmbeddedId
    private ChildPK compositeKey;

    @Column(name = "name", length = Integer.MAX_VALUE)
    private String name;

    @ManyToOne
    @JoinColumn(name = "id", insertable = false, updatable = false)
    private Parent parent;

    public Child() {
    }

    // 同步Parent关联并设置主键中的parentId
    public void setParent(Parent parent) {
        this.parent = parent;
        if (parent != null) {
            this.compositeKey.setParentId(parent.getId());
            parent.getChildren().add(this);
        }
    }
}

3. 更新Parent类，添加维护子实体的方法 #

在Parent类中新增addChild方法，确保添加Child时自动同步双向关联：

@Getter
@Setter
@Entity
@Table(name = "parent", schema = "min_max")
@SequenceGenerator(
        name = "parentSeq",
        sequenceName = "min_max.PARENT_ID_SEQ"
)
public class Parent {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO, generator = "parentSeq")
    @Column(name = "id", nullable = false)
    private Integer id;

    @Column(name = "name", length = Integer.MAX_VALUE)
    private String name;

    @OneToMany(cascade = CascadeType.ALL, mappedBy = "parent", orphanRemoval = true)
    private Set<Child> children = new LinkedHashSet<>();

    // 维护双向关联的方法
    public void addChild(Child child) {
        children.add(child);
        child.setParent(this);
    }
}

4. 修改服务层代码，使用关联维护方法 #

创建数据时调用Parent的addChild方法，确保双向关联被正确设置：

Parent p = new Parent();
p.setName("C");

Child c = new Child();
ChildPK cpk = new ChildPK();
cpk.setSomeColumn("ABC");
c.setCompositeKey(cpk);
c.setName("Child C");

// 用addChild方法维护关联
p.addChild(c);

parentRepository.save(p);

修复原理 #

• 复合主键使用基本类型存储Parent ID，避免了实体关联在主键中的持久化顺序问题，JPA能在Parent生成ID后自动填充Child主键的parentId。
• 通过addChild和setParent方法维护双向关联，确保JPA识别到Child与Parent的绑定关系，触发CascadeType.ALL的级联插入操作。

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