JPA父子表关联：子表外键未插入父表主键值问题排查

我来帮你梳理下这个常见的JPA关联配置坑点，结合你的场景（父表@OneToMany、子表@ManyToOne关联，但子表外键未写入），大概率是以下几个配置或操作环节出了问题，咱们一个个排查：

1. 双向关联的维护端没维护好 #

JPA的双向关联里，@ManyToOne的一方是关联的维护端（Owner），JPA只会根据维护端的状态来更新外键。如果你只把子对象添加到父表的集合里，但没在子对象中设置父对象的引用，那外键肯定不会自动填充。

举个错误和正确的操作对比：

• ❌ 错误操作：

  Parent parent = new Parent();
  parent.getChildren().add(new Child());
  entityManager.persist(parent);
  

• ✅ 正确操作：

  Parent parent = new Parent();
  Child child = new Child();
  child.setParent(parent); // 必须设置维护端的引用
  parent.getChildren().add(child);
  entityManager.persist(parent);
  

  更优雅的方式是在父表中封装addChild方法，自动维护双向关联：

  public void addChild(Child child) {
      this.children.add(child);
      child.setParent(this);
  }
  

2. @OneToMany缺少mappedBy属性 #

双向关联时，@OneToMany必须指定mappedBy属性，指向子表中@ManyToOne的属性名。如果没加这个配置，JPA会默认认为是单向关联，自动生成一张中间关联表，而不是在子表中创建外键列，自然就不会有外键值写入。

正确的父表@OneToMany配置示例：

@OneToMany(mappedBy = "parent", cascade = CascadeType.ALL)
private List<Child> children = new ArrayList<>();

这里的mappedBy = "parent"对应子表中private Parent parent;这个属性名。

3. 子表@ManyToOne未指定@JoinColumn #

如果子表的@ManyToOne没配置@JoinColumn，JPA会自动生成默认的外键列名（比如parent_id），但如果你的数据库表中外键列名和默认值不一致，就会导致写入失败，外键为NULL。

正确的子表配置示例：

@ManyToOne
@JoinColumn(name = "parent_id") // 这里的name要和数据库子表的外键列名完全一致
private Parent parent;

4. Cascade配置或保存顺序问题 #

如果你的cascade类型没包含PERSIST或ALL，当你只保存父表时，子表不会被级联保存；但你说子表已经插入了记录，那可能是你单独保存了子表，却没在保存子表前设置父对象引用。

比如单独保存子表时，必须先关联父对象：

Child child = new Child();
child.setParent(parent); // 先关联已存在的父对象
entityManager.persist(child);

完整的正确配置示例 #

父表（Parent.java） #

package com.springboot.model;

import javax.persistence.*;
import java.util.ArrayList;
import java.util.List;

@Entity
public class Parent {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

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

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

    // 封装添加子对象的方法，自动维护双向关联
    public void addChild(Child child) {
        children.add(child);
        child.setParent(this);
    }

    // getter、setter省略
}

子表（Child.java） #

package com.springboot.model;

import javax.persistence.*;

@Entity
public class Child {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "child_name")
    private String childName;

    @ManyToOne
    @JoinColumn(name = "parent_id")
    private Parent parent;

    // getter、setter省略
}

保存操作示例 #

// 创建父对象
Parent parent = new Parent();
parent.setName("测试父对象");

// 创建子对象并关联
Child child1 = new Child();
child1.setChildName("测试子对象1");
parent.addChild(child1);

Child child2 = new Child();
child2.setChildName("测试子对象2");
parent.addChild(child2);

// 保存父对象，子对象会被级联保存，外键自动填充
entityManager.persist(parent);

你可以对照上面的点检查自己的代码，大概率能解决外键为NULL的问题。

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