Java/Spring/Hibernate迁移后@Transactional事务不生效问题排查

1. 迁移后事务无法激活的核心原因 #

结合版本变更与排查信息，核心原因集中在三点：

• Hibernate 5.4的严格事务约束：悲观锁操作（LockModeType.PESSIMISTIC_WRITE）被强制要求在活跃事务上下文执行，旧版本Hibernate可能允许非事务下执行（不符合规范），当Spring事务切面未生效时直接触发异常；
• Spring 5事务代理逻辑调整：部分服务类的事务代理未正确生成，比如类包含final方法导致JDK代理无法拦截，或是注解继承规则变更导致@Transactional未被解析；
• 事务同步时机不匹配：Spring 5对TransactionSynchronizationManager的绑定逻辑更严格，Hibernate 5.4的EntityManager未被正确绑定到当前事务线程，导致TransactionSynchronizationManager.isActualTransactionActive()返回false。

2. Spring 5与Hibernate 5.4影响事务管理的已知变更 #

Spring 5.x 相关变更 #

• 代理模式与注解继承：
  • Spring 5.2+默认使用CGLIB代理（即使类实现接口），5.1版本若未显式设置proxyTargetClass=true，JDK代理无法拦截final方法，导致事务不生效；
  • @Transactional注解的继承规则收紧：子类重写父类方法时，默认不会继承父类的@Transactional配置，需显式添加注解或设置inheritance = InheritanceType.TRANSACTIONAL；
• 事务同步机制：
  • TransactionSynchronizationManager的资源绑定逻辑更严格，EntityManager必须在事务启动后绑定，否则无法关联到当前事务；
  • 原生支持JPA 2.2，调整了与Hibernate等JPA实现的事务交互流程；
• 切面优先级：事务切面的默认优先级被调整，若与其他切面（如缓存、异步）叠加，可能导致事务切面未先执行。

Hibernate 5.4 相关变更 #

• 悲观锁的事务强制要求：执行带悲观锁的查询时，必须处于活跃事务中，否则直接抛出TransactionRequiredException，旧版本Hibernate可能隐式允许非事务执行；
• EntityManager生命周期管理：EntityManager的解绑、关闭逻辑更严格，若Spring事务同步未正确处理，会导致线程中无可用的事务绑定EntityManager；
• API兼容性：移除了部分旧事务API（如HibernateTransactionManager的部分内部方法），官方推荐使用标准JPA的JpaTransactionManager。

3. Java版本迁移的关联与解决方案 #

关联分析 #

Java 8到11的迁移本身不会直接导致事务异常，但可能间接引发问题：

• Java 9+的模块系统（JPMS）若未正确配置，会导致Spring、Hibernate的事务相关类无法被正常加载；
• Java 11对反射的限制更严格，可能导致CGLIB代理无法生成（若使用CGLIB代理模式）。

解决方案 #

• 调整事务代理配置：在@EnableTransactionManagement中添加proxyTargetClass = true，强制使用CGLIB代理，避免JDK代理无法拦截final方法的问题；
• 修复注解继承问题：确保所有需要事务的方法（包括子类重写的方法）都显式添加@Transactional，或在父类注解中设置inheritance = InheritanceType.TRANSACTIONAL；
• 替换事务管理器：将原有的HibernateTransactionManager替换为JpaTransactionManager，适配Hibernate 5.4的JPA规范实现；
• 验证事务同步状态：在异常方法中添加调试代码，检查TransactionSynchronizationManager.getResource(entityManagerFactory)是否返回非null值，确认EntityManager是否绑定；
• 处理Java模块问题：若应用使用JPMS，在module-info.java中添加requires spring.transaction; requires hibernate.core;等依赖声明；
• 调整切面优先级：为事务切面设置最高优先级（@Order(Ordered.HIGHEST_PRECEDENCE)），确保事务逻辑先于其他切面执行；
• 检查Repository调用方式：确保悲观锁方法是通过Spring管理的Bean调用，避免直接实例化EntityManager或Repository对象。

内容的提问来源于stack exchange，提问作者Олег Гаврилів