级联合并主键冲突：Eclipselink合并大量OneToMany关联实体报唯一约束错误

1. 序列配置与JPA实现逻辑不匹配：你在@SequenceGenerator中设置的allocationSize值，与Oracle数据库侧SEQ_ALM_INVENTHIST序列的INCREMENT BY值不一致，这是该类主键冲突的最常见诱因。EclipseLink的序列生成逻辑会按照allocationSize的值在内存预分配ID段，当与数据库序列的实际增量不匹配时，就会出现重复分配ID的问题。300条记录刚好触发EclipseLink的批量操作阈值，小批量场景下因为不会触发ID段的二次分配，不会暴露该问题。其他同架构系统未复现，大概率是其序列配置与allocationSize匹配，未出现该错位。
2. 持久化配置放大了问题影响：你配置了eclipselink.persistence-context.flush-mode = commit，所有SQL都会积压到事务提交时才批量执行，同时eclipselink.id-validation = NULL关闭了EclipseLink的ID合法性校验，内存阶段不会检测到ID重复，直到请求提交到数据库才触发唯一约束报错。
3. 关联集合处理逻辑异常：在开启orphanRemoval = true的前提下，如果你合并Inventory实体时是直接替换整个inventoryHistoryList集合，而非在原有持久态集合上做增删操作，EclipseLink识别关联实体状态时可能出错，将已经分配过ID的实体判定为新实体，重复触发插入逻辑。

1. 修正序列相关配置 #

• 首先联系DBA确认SEQ_ALM_INVENTHIST序列的INCREMENT BY值，将@SequenceGenerator中的allocationSize调整为和该值完全相等。如果需要提升批量插入性能，建议将序列的INCREMENT BY调整为50，对应allocationSize也设为50，避免频繁查询数据库序列。
• 检查InventoryHistory实体的ID字段注解，确保显式绑定了序列生成器，示例如下：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "SEQ_ALM_INVENTHIST")
@Column(name = "ID_INVENT_HIST", nullable = false)
private Long id;

• 在persistence.xml中新增配置，指定数据库版本为Oracle12，避免EclipseLink用通用序列逻辑适配Oracle导致异常：

<property name="eclipselink.target-database" value="Oracle12"/>

2. 调整持久化上下文配置 #

• 可选方案1：将eclipselink.persistence-context.flush-mode改回默认值AUTO，批量插入关联记录时，每插入100条主动调用entityManager.flush()手动刷新，避免大量SQL积压到事务提交阶段执行。
• 可选方案2：将eclipselink.id-validation调整为默认值NEGATIVE，开启EclipseLink的ID合法性校验，在内存阶段提前发现ID重复问题，降低排查成本。

3. 优化关联集合更新逻辑 #

• 合并Inventory实体时，不要直接给inventoryHistoryList赋值新的List对象，而是从持久态Inventory实例中获取已有的集合，调用add()/remove()方法更新元素，避免EclipseLink误将游离态实体识别为新实体触发重复插入。
• 如果单次新增关联记录超过500条，建议关闭Inventory上的级联合并配置，手动持久化InventoryHistory实体，减少级联操作的状态处理开销，避免状态判断异常。

4. 临时验证方案 #

如果需要快速定位问题，可以临时将allocationSize调整为1，同时要求DBA将SEQ_ALM_INVENTHIST序列的INCREMENT BY也设为1、关闭序列缓存，观察300条以上的插入场景是否还会报错，即可验证是否为序列配置不匹配导致的问题。

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