JPA执行插入语句时为何关联子实体的外键无法正常赋值

你碰到的插入子表时PARTY_ID为NULL的报错，和你手动给实体字段赋值的操作没关系，是几个实体映射配置冲突共同导致的：

• 单向@OneToMany关联的默认执行时序和数据库非空约束不兼容
  你在父类Party的关联字段上配的@JoinColumn(name = "PARTY_ID")是典型的单向一对多映射写法，Hibernate对这类映射的默认执行逻辑是：
  1. 先执行子表DV_LOAN_PARTICIPANTS的INSERT语句，此时不会填充被@JoinColumn标记的PARTY_ID字段（值默认是NULL）
  2. 等子表插入完拿到主键后，再执行一条UPDATE语句，把刚插入的子表记录的PARTY_ID更新成父实体的partyId值
     因为你的DV_LOAN_PARTICIPANTS表的PARTY_ID列开了非空约束，第一步插NULL的时候就直接被数据库拦截，根本走不到后面的UPDATE步骤。
• 关联映射的托管权限会覆盖子实体的手动赋值
  只要@JoinColumn标注在父类的关联字段上，Hibernate就会认定这个外键列的赋值完全由父类的关联关系管理，直接忽略你在子实体上手动set的partyId值——哪怕你打印对象的时候能看到值是完整的，生成INSERT语句的时候也不会把这个值带进去。
• 同一个数据库列被两套映射逻辑抢占控制权
  目前DV_LOAN_PARTICIPANTS表的PARTY_ID列，同时绑定了两个映射规则：
  1. 子实体DVLoanParticipants上标记为@Id的主键映射，对应你手动设置的partyId值
  2. 父类关联字段下标记为@JoinColumn的外键映射，对应关联关系维护的外键值
     两套逻辑同时控制同一个列，Hibernate会优先按照关联映射的逻辑赋值，进一步放大前面的问题影响。
• 复合主键配置不完整
  子实体DVLoanParticipants是用PARTY_ID + DVP_PARTICIPANT_NAME作为联合主键的，但没有通过@IdClass或者@EmbeddedId显式声明复合主键结构，Hibernate识别不出来主键字段和外键字段的对应关系，也会导致赋值逻辑混乱。

根据业务场景二选一即可：

• 方案1：调整为双向关联，把外键维护权转移到子实体侧
  1. 在子实体DVLoanParticipants上加一个指向Party的关联字段，标记@ManyToOne，关联外键为PARTY_ID，让子实体成为外键关系的维护方
  2. 父类的dvLoanParticipantsMap字段去掉@JoinColumn配置，改用mappedBy = "party"声明关联由子实体的字段管理
     调整后Hibernate会在插入子表的时候直接携带父实体的PARTY_ID值，不会出现先插NULL再UPDATE的时序问题。
• 方案2：保留单向映射，理顺列的映射权限
  1. 子实体DVLoanParticipants去掉单独标记@Id的PARTY_ID字段，把原来的联合主键改成@EmbeddedId的写法，明确声明主键包含PARTY_ID和DVP_PARTICIPANT_NAME
  2. 父类的@JoinColumn注解上增加insertable = false, updatable = false配置，把这个列的赋值权完全交给子实体的主键映射
     调整后Hibernate不会再覆盖你在子实体上设置的partyId值，插入数据时会直接携带正确值完成操作。

补充提醒：使用单向映射时，一定要保证@MapKey指定的dvpParticipantName字段值和Map存储的key完全匹配，否则后续更新关联数据时会出现映射不一致的问题。

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