Java 21不可变List替换实体集合时Hibernate merge抛出UnsupportedOperationException

核心原因 #

Hibernate 对持久化状态（Managed）实体的集合属性采用内容修改优先的策略，而非直接替换集合引用。当你将实体的集合属性替换为不可变List后，Hibernate 在合并状态时会尝试修改这个不可变集合（调用clear()），而不可变集合不支持修改操作，因此抛出异常。

Hibernate Merge 流程的详细拆解 #

结合你的代码和调试信息，整个流程如下：

1. 第一次save后的状态
   第一次调用serviceItemRepository.save(serviceItem)后，saved成为Hibernate管理的持久化实体，其pricingList被Hibernate替换为自身的PersistentBag实现（用于懒加载、脏检查等功能），同时Hibernate在持久化上下文（Persistence Context）中保存了该实体的快照（快照中pricingList为空的PersistentBag）。

2. 替换集合引用
   你通过saved.setPricingList(pricingList)将pricingList属性替换为Java 21的不可变ListN。此时saved仍是持久化状态，但它的集合属性已经变成了非Hibernate管理的不可变集合。

3. 第二次save触发Merge
   第二次调用save()时，由于saved已经是持久化实体，Spring Data JPA会触发Hibernate的merge操作，目的是同步当前实体状态与持久化上下文的快照。

4. 集合属性的Merge逻辑
   在处理集合属性时，Hibernate的CollectionType.replace()方法会执行以下操作：

   • 对比当前实体的集合（不可变ListN）与快照中的集合（PersistentBag）
   • 调用replaceElements()方法，尝试将快照集合的内容合并到当前集合中
   • 在replaceElements()内部，Hibernate会先调用当前集合的clear()方法，准备复制新元素
   • 由于当前集合是不可变ListN，不支持clear()操作，直接抛出UnsupportedOperationException

为什么Hibernate不直接使用新的集合引用？ #

Hibernate的Persistent集合（如PersistentBag、PersistentList）与持久化上下文深度绑定，承担了以下核心功能：

• 懒加载集合元素
• 跟踪集合的脏状态（用于自动更新数据库）
• 处理级联操作（如CascadeType.ALL）
• 管理集合元素的生命周期（如orphanRemoval=true）

如果直接替换为普通Java集合，这些功能都会失效。因此Hibernate设计为优先修改集合内容，而非替换集合引用，以此保证自身的集合管理机制正常运行。

内容的提问来源于stack exchange，提问作者uanik.projects