Spring Boot+PostgreSQL环境下Pre-bound JDBC Connection偶发异常的排查与解决求助

首先，咱们来拆解这个异常的核心原因：

org.springframework.transaction.IllegalTransactionStateException: Pre-bound JDBC Connection found! JpaTransactionManager does not support running within DataSourceTransactionManager if told to manage the DataSource itself. It is recommended to use a single JpaTransactionManager for all transactions on a single DataSource, no matter whether JPA or JDBC access.

这个错误说明你的应用里同时存在两个事务管理器（JpaTransactionManager和DataSourceTransactionManager）在管理同一个数据源，而且JpaTransactionManager默认会自己接管数据源的连接管理，当某个操作先被DataSourceTransactionManager绑定了JDBC连接，后续JpaTransactionManager再尝试接管时就会触发冲突。这种偶发出现的情况，通常是因为不同操作（比如Liquibase迁移、某些隐式JDBC操作）随机使用了不同的事务管理器导致的。

你当前配置的问题点 #

1. 你手动定义了JpaTransactionManager并标记为@Primary，但Spring Boot会自动根据数据源配置一个DataSourceTransactionManager。即使有@Primary，某些组件（比如Liquibase、未明确指定事务管理器的JDBC操作）仍可能默认使用自动配置的DataSourceTransactionManager。
2. 你的自定义事务管理器用SessionFactory注入，虽然能工作，但更标准的JPA事务管理器配置应该使用EntityManagerFactory，避免Hibernate特定API带来的潜在冲突。

具体解决步骤 #

1. 禁用自动配置的DataSourceTransactionManager

在Spring Boot启动类上添加排除配置，阻止Spring自动创建DataSourceTransactionManager，确保整个应用只有你定义的JpaTransactionManager：

@SpringBootApplication(exclude = DataSourceTransactionManagerAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 修正自定义事务管理器的配置

把基于SessionFactory的配置改成标准的JPA风格，使用EntityManagerFactory注入，这样更贴合Spring Data JPA的设计：

@Configuration
public class TransactionManagerConfig {
    @Primary
    @Bean(name = "transactionManager")
    public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
        JpaTransactionManager transactionManager = new JpaTransactionManager();
        transactionManager.setEntityManagerFactory(entityManagerFactory);
        return transactionManager;
    }
}

3. 明确指定Liquibase使用你的事务管理器

Liquibase默认可能会尝试使用DataSourceTransactionManager，所以在配置文件里明确指定它用你定义的transactionManager：

spring:
  liquibase:
    transaction-manager: transactionManager
    # 其他Liquibase原有配置...

4. 确保手动事务管理使用正确的事务管理器

在你的EntityService里，明确指定注入的是你定义的事务管理器，避免歧义：

@Service
public class EntityService {
    @Autowired
    private DocumentRepository documentRepository;
    @Autowired
    @Qualifier("transactionManager") // 明确指定bean名称
    private PlatformTransactionManager transactionManager;

    // 你的手动事务代码...
}

5. 排查潜在的JDBC操作

如果你的应用里有用到JdbcTemplate、NamedParameterJdbcTemplate等JDBC工具类，不用额外配置——JpaTransactionManager完全支持JDBC操作，只要是同一个数据源，事务会被统一管理。

为什么之前的@Primary没解决问题？ #

@Primary只是告诉Spring当有多个同类型bean时优先选择这个，但Spring Boot自动配置的DataSourceTransactionManager仍然会被创建。某些组件（比如Liquibase）在初始化时可能会直接查找DataSourceTransactionManager类型的bean，而不是PlatformTransactionManager，这时候@Primary就不会生效，导致冲突。

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