Spring Boot中@OneToMany与@ManyToOne保存外键为空问题

问题背景 #

在Spring Boot项目中，通过@OneToMany和@ManyToOne注解为PlantVocEntity与PlantEmitterEntity建立双向关联，数据保存到PostgreSQL数据库时，发现emitters表中所有记录的外键fk_plant_id始终为空。尝试多种配置调整均未解决，最终按@Roar S.的建议调整后问题修复。

常见诱因 #

• 关系维护方未明确：JPA中@ManyToOne所在的实体是关联关系的拥有方，若保存数据时未给子实体（PlantEmitterEntity）设置父实体（PlantVocEntity）的引用，外键无法自动填充。
• @OneToMany缺少mappedBy配置：双向关联场景下，@OneToMany需通过mappedBy指定由子实体的关联字段维护关系，否则JPA可能生成中间表或忽略外键赋值逻辑。
• 保存顺序错误：先保存子实体再保存父实体，且未配置级联操作，导致父实体的ID无法同步到子实体的外键字段。

修复步骤（基于@Roar S.的建议） #

1. 修正实体类关联注解 #

• 父实体PlantVocEntity的@OneToMany需指定mappedBy并配置级联：

  @Entity
  public class PlantVocEntity {
      // 其他字段...
      @OneToMany(mappedBy = "plantVoc", cascade = CascadeType.ALL, orphanRemoval = true)
      private List<PlantEmitterEntity> emitters = new ArrayList<>();
  }
  

• 子实体PlantEmitterEntity的@ManyToOne需明确外键列名：

  @Entity
  @Table(name = "emitters")
  public class PlantEmitterEntity {
      // 其他字段...
      @ManyToOne
      @JoinColumn(name = "fk_plant_id") // 对应数据库外键列
      private PlantVocEntity plantVoc;
  }
  

2. 保存数据时维护双向关联 #

仅将子实体添加到父实体集合不足以触发外键赋值，必须同时为子实体设置父实体引用：

// 实例化父实体
PlantVocEntity plantVoc = new PlantVocEntity();
// 实例化子实体
PlantEmitterEntity emitter = new PlantEmitterEntity();

// 关键：双向维护关联关系
emitter.setPlantVoc(plantVoc);
plantVoc.getEmitters().add(emitter);

// 仅保存父实体即可，cascade = CascadeType.ALL会自动级联保存子实体
plantVocRepository.save(plantVoc);

3. 验证级联配置 #

确保@OneToMany的cascade属性包含CascadeType.PERSIST或CascadeType.ALL，保证父实体保存时，子实体的持久化操作会被同步触发，同时完成外键赋值。

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