Spring编程式/声明式事务管理异常问题求助

问题背景 #

• 项目基于SQL Schema，通过ByteBuddy+JDBC在运行时动态生成实体类，因此扩展了Spring的DefaultPersistenceUnitManager和LocalContainerEntityManagerFactoryBean类
• 手动使用EntityManager（@PersistenceContext）结合Hibernate划分事务的单元测试运行正常
• 切换为Spring管理事务时出现异常：
  • 声明式事务：TransactionInterceptor中的TransactionManager属性为null
  • 编程式事务：触发事务回滚异常（日志如下）

怀疑方向 #

由于涉及ByteBuddy的类加载操作，怀疑JpaTransactionManager依赖LocalContainerEntityManagerFactoryBean的特定特性，例如HibernateVendorAdapter或自定义的SpringHibernateJpaPersistenceProvider，而扩展类时破坏了这些依赖逻辑。

异常日志 #

2025-02-20T14:45:56.637-03:00 DEBUG 45462 --- [           main]
o.h.e.t.internal.TransactionImpl         : begin
2025-02-20T14:45:56.639-03:00 DEBUG 45462 --- [           main]
org.postgresql.jdbc.PgConnection         :   setAutoCommit = false
2025-02-20T14:45:57.783-03:00 DEBUG 45462 --- [           main]
org.hibernate.orm.sql.exec               : Skipping reading Query
result cache data: cache-enabled = false, cache-mode = IGNORE
2025-02-20T14:45:57.842-03:00 DEBUG 45462 --- [           main]
org.hibernate.SQL                        : select
sdt1_0.simple_key,sdt1_0.simple_date,sdt1_0.simple_time,sdt1_0.simple_times_zone,sdt1_0.simple_timestamp,sdt1_0.simple_timestamp_zone
from simple_date_table sdt1_0 where sdt1_0.simple_key=?
2025-02-20T14:45:57.948-03:00 DEBUG 45462 --- [           main]
org.hibernate.orm.results                : Initializer list:
org.nanotek.data.SimpleDateTable ->
EntityJoinedFetchInitializer(org.nanotek.data.SimpleDateTable)@75465588
(SingleTableEntityPersister(org.nanotek.data.SimpleDateTable))

2025-02-20T14:45:58.160-03:00 DEBUG 45462 --- [           main]
cResourceLocalTransactionCoordinatorImpl : JDBC transaction marked for
rollback-only (exception provided for stack trace)

java.lang.Exception: exception just for purpose of providing stack
trace     at
org.hibernate.resource.transaction.backend.jdbc.internal.JdbcResourceLocalTransactionCoordinatorImpl$TransactionDriverControlImpl.markRollbackOnly(JdbcResourceLocalTransactionCoordinatorImpl.java:309)
~[hibernate-core-6.6.5.Final.jar:6.6.5.Final]     at
org.hibernate.engine.transaction.internal.TransactionImpl.markRollbackOnly(TransactionImpl.java:203)
~[hibernate-core-6.6.5.Final.jar:6.6.5.Final]     at
org.hibernate.engine.transaction.internal.TransactionImpl.setRollbackOnly(TransactionImpl.java:224)
~[hibernate-core-6.6.5.Final.jar:6.6.5.Final]     at
org.springframework.orm.jpa.JpaTransactionManager$JpaTransactionObject.setRollbackOnly(JpaTransactionManager.java:716)
~[spring-orm-6.2.2.jar:6.2.2]     at
org.springframework.orm.jpa.JpaTransactionManager.doSetRollbackOnly(JpaTransactionManager.java:615)
~[spring-orm-6.2.2.jar:6.2.2]     at
org.springframework.transaction.support.AbstractPlatformTransactionManager.processRollback(AbstractPlatformTransactionManager.java:906)
~[spring-tx-6.2.2.jar:6.2.2]

调试线索（基于Spring事务内部机制） #

1. 事务管理器与EntityManagerFactory的绑定检查 #

• JpaTransactionManager必须正确关联自定义LocalContainerEntityManagerFactoryBean生成的EntityManagerFactory实例。确认扩展类的createNativeEntityManagerFactory方法未破坏原有逻辑，确保返回的EntityManagerFactory能被Spring容器识别并注入到事务管理器中。
• 检查JpaTransactionManager的setEntityManagerFactory配置，是否直接引用了自定义的LocalContainerEntityManagerFactoryBean Bean，而非默认实例。

2. 类加载器的一致性验证 #

ByteBuddy生成的动态类使用自定义类加载器时，需确保：

• DefaultPersistenceUnitManager通过setClassLoader或setPersistenceUnitPostProcessors配置了正确的类加载器，让Spring能识别动态实体类对应的持久化单元。
• Spring容器的类加载器与ByteBuddy的类加载器之间存在正确的双亲委派关系，避免事务管理器无法加载动态生成的实体类。

3. 声明式事务的切面配置排查 #

针对TransactionInterceptor的TransactionManager为null问题：

• 确认已通过@EnableTransactionManagement(proxyTargetClass = true)开启事务管理，动态生成类需CGLIB代理支持。
• 检查JpaTransactionManager是否通过@Bean正确注册为Spring Bean，且容器能扫描到该Bean；若存在多个事务管理器，需在@Transactional注解中指定value属性明确目标管理器。

4. Spring与Hibernate的事务协调逻辑检查 #

异常显示Spring触发了Hibernate的事务回滚标记，需确认：

• 自定义SpringHibernateJpaPersistenceProvider的createContainerEntityManagerFactory方法是否正确实现，确保返回的EntityManagerFactory包含Spring事务协调所需的上下文信息。
• 检查LocalContainerEntityManagerFactoryBean的setJpaVendorAdapter配置，是否正确设置了HibernateVendorAdapter，保证Spring与Hibernate的事务API兼容。

内容的提问来源于stack exchange，提问作者José Carlos Canova