Kotlin中Hibernate实体orderNumber在forEachIndexed后莫名变更的异常排查

问题重现 #

测试代码中对Hibernate实体Ecu的orderNumber字段赋值为列表索引，首次打印值与索引一致，但二次打印时出现字段值莫名变更：

val random = EasyRandom()
val parametrization = random.nextObject(Parametrization::class.java)
parametrization.ecus.forEachIndexed { index, ecu ->
    ecu.orderNumber = index
    println("index: $index, orderNumber: ${ecu.orderNumber}")
}
println("And again")
parametrization.ecus.forEachIndexed { index, ecu ->
    println("index: $index, orderNumber: ${ecu.orderNumber}")
}

打印结果异常：

index: 0, orderNumber: 0
index: 1, orderNumber: 1
index: 2, orderNumber: 2
index: 3, orderNumber: 3
index: 4, orderNumber: 4
And again
index: 0, orderNumber: 0
index: 1, orderNumber: 1
index: 2, orderNumber: 3 // <-- 异常点
index: 3, orderNumber: 3
index: 4, orderNumber: 4

Ecu实体定义：

@Entity
@Table(name = "ecus")
class Ecu(
    // ...
    @Column(name = "order_number", nullable = false, updatable = true)
    var orderNumber: Int,
    // ...
)

核心原因分析 #

这种异常通常和Hibernate对持久化实体/集合的状态跟踪机制有关，主要可能的点：

1. 持久化集合的自动状态同步 #

如果Parametrization的ecus集合是Hibernate的持久化集合实现（比如PersistentList），而非普通ArrayList：

• Hibernate会对这类集合做状态跟踪，当你修改集合元素的字段值后，Hibernate可能触发内部的同步逻辑（比如维护集合排序、关联关系），意外修改字段值。
• EasyRandom在测试环境中生成对象时，可能直接创建了Hibernate的持久化集合实例（比如依赖Spring Data JPA的测试上下文）。

2. 字节码增强导致的setter副作用 #

Hibernate的字节码增强功能会修改实体类的getter/setter方法：

• 当你给orderNumber赋值时，增强后的setter可能包含额外逻辑（比如同步关联实体、更新持久化上下文状态），导致后续访问字段时值被覆盖。

3. 集合排序注解的隐式影响 #

如果Parametrization的ecus集合配置了@OrderBy("orderNumber")或类似排序注解：

• Hibernate会在迭代集合时动态排序，若排序逻辑与手动赋值的索引不一致，可能导致元素位置错乱，看起来像是字段值变更（实际是元素顺序变了，但索引遍历的是新顺序的元素）。不过从打印结果看，此场景可能性较低。

验证与解决方法 #

快速验证 #

将持久化集合转换为普通集合，脱离Hibernate的状态跟踪：

val parametrization = random.nextObject(Parametrization::class.java)
// 转换为普通ArrayList，切断Hibernate的集合代理
parametrization.ecus = ArrayList(parametrization.ecus)
// 后续赋值、打印操作不变

若问题消失，即可确认是持久化集合导致的问题。

针对性解决 #

1. 禁用测试环境的Hibernate字节码增强：如果是字节码增强的问题，可在测试配置中关闭该功能（比如Spring Boot中调整spring.jpa.hibernate.ddl-auto参数或修改Hibernate增强配置）。
2. 调整集合注解配置：若集合使用了@OrderColumn或@OrderBy，检查注解逻辑是否与业务需求冲突，必要时移除或修改排序规则。
3. 手动初始化普通集合：在实体类中，将ecus集合初始化为普通ArrayList而非Hibernate的持久化集合，比如：

@OneToMany(mappedBy = "parametrization")
var ecus: MutableList<Ecu> = ArrayList()

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