Spring Boot3+Hibernate6解耦分离对象代理遇PersistentBag异常求助

问题场景 #

在Spring Boot 3、Hibernate 6环境中，尝试对分离状态的Hibernate懒加载对象进行解代理时，始终抛出以下异常：

java.lang.IllegalArgumentException: Unable to locate persister:
org.hibernate.collection.spi.PersistentBag

当前实现代码如下：

@Autowired
private EntityManager entityManager;

@Transactional 
public <T> T loadUnproxied(T object) {
   if (!Hibernate.isInitialized(object)) {
     Session session = entityManager.unwrap(Session.class);

     // 重新关联分离实体到会话 - 此处执行失败
     session.merge(object);

     Hibernate.initialize(object);
   }
   return object;
}

已知前提：

• 实体扫描正常，Spring可正常管理持久化操作
• 仅上述代码存在问题，疑似绕过Spring持久化路径且@Transactional未生效
• 明确不采用提前EAGER预加载方案，核心需求是传递懒加载对象并按需加载数据

问题原因 #

1. 参数类型不匹配：传入的object可能是Hibernate懒加载集合（如PersistentBag），而session.merge()仅适用于实体对象，无法处理集合类型，导致持久化器定位失败。
2. 事务未生效：若该方法是同类内部调用，Spring AOP代理不会生效，@Transactional注解无法开启事务，会话无法正常关联对象。

修正方案 #

以下代码针对实体和懒加载集合分别处理，同时确保事务生效：

@Autowired
private EntityManager entityManager;

@Autowired
private TransactionTemplate transactionTemplate;

public <T> T loadUnproxied(T object) {
    return transactionTemplate.execute(status -> {
        Session session = entityManager.unwrap(Session.class);
        
        // 处理懒加载集合（如PersistentBag）
        if (object instanceof PersistentCollection<?> persistentCollection) {
            if (!persistentCollection.wasInitialized()) {
                // 先关联集合所属的实体到会话
                Object owner = persistentCollection.getOwner();
                if (owner != null) {
                    session.lock(owner, LockMode.NONE);
                }
                Hibernate.initialize(persistentCollection);
            }
        } 
        // 处理实体对象
        else if (!Hibernate.isInitialized(object)) {
            Class<?> entityClass = Hibernate.getClass(object);
            Serializable id = session.getIdentifier(object);
            // 通过ID重新加载实体，确保关联到当前会话并初始化
            T reloadedEntity = session.get(entityClass, id);
            Hibernate.initialize(reloadedEntity);
            return reloadedEntity;
        }
        
        return object;
    });
}

关键说明 #

• 事务管理：使用TransactionTemplate手动管理事务，避免内部调用导致的AOP失效问题，确保会话操作在事务上下文内执行。
• 集合处理：懒加载集合需先关联其所属实体到会话，再调用Hibernate.initialize()，而非直接对集合执行merge。
• 实体处理：通过session.get()重新加载实体（而非merge），更适合仅需加载数据的场景，避免不必要的状态合并操作。

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