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只管理 JPAEntityManager的请求级生命周期,不会让StatelessSession变成受管 Session。- 如果业务依赖懒加载,关闭
open-in-view后要在服务层完成数据加载,避免视图渲染阶段触发LazyInitializationException。
备注:内容仅供参考。
