JPA使用@MapsId映射父实体填充复合主键时对应字段返回null问题

• 注解配置的生效范围认知偏差：将insertable=false、updatable=false配置在嵌入主键类InsurancePK的personId字段上时，这类列级配置在主流JPA实现（如Hibernate）中不会被正确识别，反而会让JPA在字段写入阶段直接跳过该字段的映射流程——哪怕@MapsId已经获取到父实体的主键值，也无法将值回填到嵌入主键的对应内存字段中。
• 双向绑定的关联链路缺失：@MapsId("personId")的取值源是Insurance实体上标注的@ManyToOne Person关联属性，如果在addInsurance方法中仅将Insurance加入Person的关联集合，没有反向给Insurance的Person关联属性赋值，JPA在执行映射填充时根本找不到取值来源，自然无法填充personId字段。
• 持久化级联配置缺失：Person采用IDENTITY策略生成主键，这类主键的生成时机是执行INSERT语句时立刻将生成值回填到实体对象；但如果@OneToMany关联没有配置CascadeType.PERSIST，JPA在保存Person时不会触发关联Insurance实体的映射预处理流程，@MapsId的自动填充逻辑根本不会被执行。
• 常见误区澄清：@EmbeddedId配合@MapsId的设计本身就支持父实体ID自动填充到复合主键字段，不需要手动为复合主键的关联ID字段赋值，出现取值为null的问题本质都是配置或绑定逻辑的断点，不是注解本身的功能缺陷。

• 调整列权限的注解配置位置：移除嵌入主键类InsurancePK中personId字段上的可写/可更新注解，改为在Insurance实体的嵌入主键映射上做列重写配置，确保权限配置被JPA正确识别，同时不阻断字段的自动填充流程：

  // Insurance实体类内的嵌入主键映射
  @EmbeddedId
  @AttributeOverride(
      name = "personId",
      column = @Column(name = "person_id", insertable = false, updatable = false)
  )
  private InsurancePK id;
  
  // 对应的@ManyToOne关联配置
  @MapsId("personId")
  @ManyToOne
  @JoinColumn(name = "person_id")
  private Person person;
  

• 补全双向绑定的关联引用：修正addInsurance方法的逻辑，在将Insurance加入Person关联集合的同时，显式给Insurance的Person关联属性赋值，打通@MapsId的取值链路：

  // Person实体类内的双向绑定方法
  public void addInsurance(Insurance insurance) {
      // *关键：打通@MapsId的取值源，让JPA能从该关联属性上读取Person的ID*
      insurance.setPerson(this);
      this.insuranceList.add(insurance);
  }
  

• 配置正确的持久化级联：在Person实体的一对多关联上添加PERSIST级联，确保JPA在执行Person持久化时，会同步触发关联Insurance实体的映射预处理、ID填充流程：

  // Person实体类内的一对多关联配置
  @OneToMany(mappedBy = "person", cascade = CascadeType.PERSIST, orphanRemoval = true)
  private List<Insurance> insuranceList = new ArrayList<>();
  

• 简化业务层的赋值逻辑：调整完成后，业务层初始化Insurance时只需要给复合主键填充保险类型、保单号两个业务字段即可，不需要手动给复合主键设置personId值，JPA会在持久化阶段自动将Person生成的IDENTITY主键值回填到对应字段。

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