Hibernate3升级到Hibernate5.6出现Found shared references to a collection报错求助

问题根因说明 #

该报错由Hibernate 3.x到5.x版本间集合归属校验逻辑收紧导致，即使未显式修改集合内容，只要Hibernate检测到集合实例被绑定到多个持久化上下文、或者多个实体实例，就会触发校验失败。

排查步骤 #

• 检查自研Session生命周期管理逻辑：确认是否存在同一User实例被先后关联到两个不同Session的情况。即使内存中仅存在一个User实例，前一个Session加载时已给roles集合绑定了所属上下文，后续Session再关联该User实例时就会触发共享引用校验报错。
• 检查实体拷贝逻辑：如果代码中存在User对象的浅拷贝逻辑，即使没有修改集合内容，只要拷贝后的对象也被纳入持久化上下文，同一个集合实例就会被两个实体对象关联，触发报错。
• 检查自研save方法实现：如果对已处于持久化状态的User实例重复调用session.update()，会触发Hibernate重新绑定集合归属，也可能触发该报错。

快速验证方案 #

在执行save/flush操作前，手动替换roles集合为新的实例，解除原有绑定关系：

// 假设当前获取到的用户实例为user
List<Role> roleList = user.getRoles();
user.setRoles(new ArrayList<>(roleList));
// 后续执行save/flush操作

如果执行后报错消失，即可确认是集合实例跨上下文绑定导致的问题。

永久修复方案 #

• 完善Session生命周期管理：每次请求结束后彻底关闭Session，确保所有持久化实例转为游离态，禁止跨Session复用带有Hibernate代理集合的实体实例。
• 如需跨请求缓存User实例，缓存前将集合属性替换为普通Java集合实例，不要保留Hibernate返回的PersistentBag、PersistentSet等代理集合实例。
• 可在User.hbm.xml的roles bag配置中添加inverse="true"属性，降低集合归属校验的触发概率。

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