多事务管理器环境下无法打开JPA EntityManager的问题求助

问题描述 #

初始报错：

线程已绑定键为[HikariDataSource (HikariPool-1)]的值[org.springframework.jdbc.datasource.ConnectionHolder@20f78dcb]

最初为JDBC模板配置事务管理器：

@Bean
@Primary
public PlatformTransactionManager dbTxManager() {
    return new DataSourceTransactionManager(clientDestinationDataSource());
}

此时数据库读取正常，但写入操作失败，报错：

抛出异常；嵌套异常为org.springframework.beans.factory.NoSuchBeanDefinitionException: 找不到名为'transactionManager'的bean：未找到符合限定符'transactionManager'的TransactionManager bean——既不匹配限定符也不匹配bean名称！

即使在@Transactional注解中显式指定事务管理器，问题仍未解决：

ClientRepositry repo;

@Transactional("dbTxManager")
@Override
public Long processClient(Client client){
    repo.findById(client.getId())

    ...

    repo.save(client); //error
}

随后配置独立EntityManager：

@EnableJpaRepositories(
        entityManagerFactoryRef = "clientEntityManagerFactory",
        transactionManagerRef = "transactionManagerSimple",
        basePackages = "com.integration")
@EnableTransactionManagement
@Configuration
public class DbConfiguration {

    @Bean
    public HikariDataSource clientDataSource(DataSourceProperties clientDestinationDbProps) {
        return clientDestinationDbProps
                .initializeDataSourceBuilder()
                .type(HikariDataSource.class)
                .build();
    }


    @Bean
    public LocalContainerEntityManagerFactoryBean clientEntityManagerFactory(HikariDataSource clientDataSource) {
        LocalContainerEntityManagerFactoryBean entityManagerFactoryBean = new LocalContainerEntityManagerFactoryBean();
        entityManagerFactoryBean.setDataSource(clientDataSource);
        entityManagerFactoryBean.setPackagesToScan(
                "com.integration.domain",
                "com.integration.repository"
        );

        JpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        entityManagerFactoryBean.setJpaVendorAdapter(vendorAdapter);

        Properties properties = new Properties();
        properties.setProperty("hibernate.dialect", "org.hibernate.dialect.PostgreSQLDialect");
        entityManagerFactoryBean.setJpaProperties(properties);

        return entityManagerFactoryBean;
    }

    @Bean
    public PlatformTransactionManager transactionManagerSimple(EntityManagerFactory clientEntityManagerFactory) {
        return new JpaTransactionManager(clientEntityManagerFactory);
    }
}

注：basePackages = "com.integration"为配置EntityManager时，当前数据源所有组件的根扫描目录。

现在处理数据时无法打开事务，报错：

抛出异常；嵌套异常为org.springframework.transaction.CannotCreateTransactionException: 无法为事务打开JPA EntityManager；嵌套异常为java.lang.IllegalStateException: 线程已绑定键为[HikariDataSource (HikariPool-1)]的值[org.springframework.jdbc.datasource.ConnectionHolder@20f78dcb]

解决思路 #

• 清理冲突的事务管理器：
  你同时配置了DataSourceTransactionManager和JpaTransactionManager，且前者标记了@Primary，会导致Spring事务管理逻辑混淆。如果DAO层基于Spring Data JPA实现，直接移除DataSourceTransactionManager的配置，只保留与EntityManager绑定的JpaTransactionManager。

• 确认事务管理器与EntityManager绑定一致性：
  检查@EnableJpaRepositories的transactionManagerRef属性值，确保与你定义的JpaTransactionManager的bean名称完全匹配（当前配置中transactionManagerSimple是正确的，但要排查是否有其他配置覆盖了该绑定）。

• 修复线程连接残留问题：
  报错提示线程已绑定ConnectionHolder，说明存在连接未正确释放的情况：

  1. 检查是否有非Spring管理的原生JDBC操作直接获取数据源连接，未执行关闭操作；
  2. 确保所有数据库操作都通过Spring事务管理控制，避免混合使用原生JDBC和JPA操作同一数据源。

• 验证事务注解的代理有效性：
  确保@Transactional标注的方法是Spring代理对象调用的——避免在同一类内部直接调用事务方法（会绕过代理），可以通过@Autowired注入自身实例来调用事务方法，保证事务切面生效。

• 确认数据源唯一性：
  检查clientDataSource是否为唯一的数据源bean，没有其他同名或标记@Primary的数据源覆盖它，避免EntityManager和事务管理器使用不同数据源导致冲突。

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