Hibernate持久化List时add指定位置元素顺序错乱如何配置修复

问题原因 #

默认情况下，Hibernate对未配置顺序维护规则的List类型关联属性，会作为无序集合处理，关联表仅存储关联双方的ID映射，没有额外字段存储列表元素的索引位置，因此无法保留你在内存中设置的元素插入顺序，每次更新关联关系时都会删除原有所有关联记录再全量重新插入，插入顺序也不会和内存中列表的顺序对应。

解决方案 #

只需要在stages属性上添加@OrderColumn注解，Hibernate会自动在关联表中新增一列存储每个元素的索引位置，持久化和查询时都会自动维护该顺序，无需额外手动处理。

修改后的代码示例：

@javax.persistence.Entity
@javax.persistence.Table(name = "WORKFLOW")
public class Workflow implements java.io.Serializable {

    @javax.persistence.OneToMany(cascade = {javax.persistence.CascadeType.ALL})
    @org.hibernate.annotations.LazyCollection(org.hibernate.annotations.LazyCollectionOption.FALSE)
    // 新增OrderColumn注解，name指定关联表中存储索引的列名
    @javax.persistence.OrderColumn(name = "STAGE_ORDER", nullable = false)
    private java.util.List<Stage> stages;

// 其余代码保持不变
...
}

注意事项 #

• 新增注解后首次启动应用时，Hibernate会自动在WORKFLOW_STAGES关联表中添加你指定的索引列（上述示例中列名为STAGE_ORDER），如果表中已有历史数据，需要提前给历史数据补全索引值，避免启动报错。
• 配置@OrderColumn后，Hibernate支持列表顺序的增量更新，无需再全量删除重插关联表数据，也会保留你调用add(position, element)设置的元素顺序。

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