PAYATHON 2026

Hibernate StatelessSession 与 open-in-view 如何配合使用

数据小陈

结论

HibernateTransactionManager.setHibernateManagedSession(true) 并不能解决这个 ClassCastException。异常原因是当前线程已经绑定了 JPA 的 EntityManagerHolder,而 HibernateTransactionManager 却按 SessionHolder 去取同一个同步资源,取到的类型对不上。StatelessSession 不是 JPA EntityManager,不应依赖 spring.jpa.open-in-view。在 Spring Data JPA 项目里,建议保留 JpaTransactionManager,把 StatelessSession 放到自定义 repository fragment 或独立 DAO 中使用。

原因

open-in-view 拦截器会在请求线程里绑定 EntityManagerHolder。Hibernate 的 SessionFactory 实现通常也同时是 EntityManagerFactory,所以 HibernateTransactionManager 用 SessionFactory 作为 key 查资源时,可能拿到同一个底层对象上绑定的 EntityManagerHolder。HibernateTransactionManager.doGetTransaction() 期望的是 SessionHolder,强转失败,于是报 EntityManagerHolder cannot be cast to SessionHolder。setHibernateManagedSession(true) 只影响 Hibernate 管理 Session 的方式,不会改变 holder 的类型,因此对这个问题没有作用。

推荐做法

方案一:保留 JpaTransactionManager,关闭 open-in-view(推荐)

spring.jpa.open-in-view=false

不要为了 StatelessSession 把全局事务管理器换成 HibernateTransactionManager。可以让 Spring Boot 自动配置 JpaTransactionManager,也可以显式保留它。自定义 fragment 示例:

@Repository
public class CityStatelessRepository {

    private final SessionFactory sessionFactory;

    public CityStatelessRepository(EntityManagerFactory emf) {
        this.sessionFactory = emf.unwrap(SessionFactory.class);
    }

    public boolean existsCity(String name) {
        try (StatelessSession ss = sessionFactory.openStatelessSession()) {
            Long count = ss.createQuery(
                    "select count(c) from City c where c.name = :name", Long.class)
                .setParameter("name", name)
                .uniqueResult();
            return count != null && count > 0;
        }
    }
}

这种方式下,StatelessSession 使用独立连接和独立事务,不参与外层 JPA 事务。如果希望和 JPA 写操作共用同一个原子事务,应改用普通 EntityManager 或 Session,或者把事务边界设计清楚。

方案二:需要使用 SharedSessionCreator 时

保留 JpaTransactionManager,不要再把 HibernateTransactionManager 配成同一个 SessionFactory 上的主事务管理器。StatelessSession 应按需创建,不要做成单例 bean:

@Component
public class StatelessSessionProvider {

    private final SessionFactory sessionFactory;

    public StatelessSessionProvider(EntityManagerFactory emf) {
        this.sessionFactory = emf.unwrap(SessionFactory.class);
    }

    public StatelessSession openShared() {
        return SharedSessionCreator.createSharedStatelessSession(sessionFactory);
    }
}

在事务方法里按每次调用创建并关闭:

@Transactional(readOnly = true)
public boolean existsCity(String name) {
    try (StatelessSession ss = statelessSessionProvider.openShared()) {
        Long count = ss.createQuery(
                "select count(c) from City c where c.name = :name", Long.class)
            .setParameter("name", name)
            .uniqueResult();
        return count != null && count > 0;
    }
}

SharedSessionCreator 属于比较底层的 Hibernate API,包名和可见性可能随版本变化,使用前要按实际 Hibernate 版本确认。

不建议的做法

不要在启用 open-in-view 时,把 HibernateTransactionManager 和 JpaTransactionManager/EntityManagerHolder 混在同一个线程、同一个 SessionFactory 上。如果确实必须用 HibernateTransactionManager,通常只能关闭 open-in-view,或者让 StatelessSession 使用完全独立的 SessionFactory/DataSource 和事务管理器。

注意事项

  • StatelessSession 不是线程安全的。原配置里的 @Bean public StatelessSession ... 默认是单例,跨请求共享会有风险。应在每次调用时创建并关闭,或用 ObjectProvider<StatelessSession> 按需获取。
  • Spring Data JPA 的标准 repository 不能直接把 StatelessSession 当作底层 EntityManager 使用。需要通过自定义 repository fragment、自定义 DAO 或服务层实现。
  • open-in-view 只管理 JPA EntityManager 的请求级生命周期,不会让 StatelessSession 变成受管 Session。
  • 如果业务依赖懒加载,关闭 open-in-view 后要在服务层完成数据加载,避免视图渲染阶段触发 LazyInitializationException。

备注:内容仅供参考。