JPA OneToMany双向关联下如何单次merge更新多个关联对象

• 双向关联对象图状态不一致触发EclipseLink静默校验拦截
  按照当前关联配置，PrincipalRoles是持有外键的关系维护方，Principal端通过mappedBy标记反向关联，关联关系的持久化生效完全由子实体的principal字段值决定。从已排查的现场状态看，页面编辑过程中，仅被手动修改过的PrincipalRoles实例的principal字段被赋值为当前主对象引用，集合内其余未改动的PrincipalRoles实例的principal字段已被清空为null。
  当集合内仅存在1个被修改的子实例时，EclipseLink级联merge主对象的逻辑会顺着关联关系，自动将集合内所有子实例的principal字段补全为持久化上下文中的主对象受管引用，整个对象图状态一致，合并操作可正常刷写数据库。
  当集合内存在2个及以上被修改的子实例时，EclipseLink的集合差异对比器会检测到对象图状态冲突：同一主对象关联的集合内，部分子实例关联值指向分离态主对象、部分子实例关联值为null，触发内部对象图一致性校验失败，直接将本次merge涉及的所有修改（包括主对象自身的名称、邮箱等基础字段更新）从持久化上下文的刷写队列中移除。该校验失败属于EclipseLink内部非致命逻辑分支，不会向外抛出任何异常，最终事务正常提交，数据库自然无任何变更。
• 实体equals/hashCode实现放大了校验误判
  当前所有实体的equals/hashCode完全依赖主键id值，在EclipseLink做集合内实体身份匹配时，会将集合内带相同主键id、principal字段为null的未修改子实例，与同样带相同主键id、principal字段已赋值的修改后子实例判定为重复实体，进一步触发一致性拦截逻辑。

• 页面操作阶段补全对象图一致性：在将修改后的Principal实体传入Facade层merge前，遍历rolesByPrincipalCollection集合内的所有PrincipalRoles实例，强制将每个子实例的principal字段设置为当前主对象引用，杜绝集合内出现principal为null的子实例，从根源上消除对象图状态冲突。
• 调整Facade层合并逻辑：不要直接对传入的分离态主对象执行全量级联merge，先通过实体管理器的find方法获取持久化上下文中的受管主对象，再手动同步主表字段值、子集合的增删改差异，绕过EclipseLink对分离态对象图的全量校验环节。
• 开启调试日志验证：通过持久化单元配置将eclipselink.logging.level设置为FINE，观测合并操作的日志输出，可以直接定位到对象图校验阶段的拦截点，确认问题复现链路。

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