Spring Boot集成HikariCP连接DB2时活跃连接始终为1无法释放的问题求助

你遇到的核心问题是EntityManager生命周期管理不当，导致连接被长期占用，无法归还到连接池。结合你的代码和配置，我给你几个针对性的解决方案：

1. 不要将EntityManager定义为单例Bean #

你当前通过@Bean创建的appEntityManager是一个单例实例，但EntityManager本身是非线程安全的——单例的EntityManager会一直持有从连接池获取的连接，哪怕你调用close()，Spring的Bean代理机制也可能阻止它真正释放连接。

修正方案：移除自定义EntityManager Bean，改用@PersistenceContext注入 #

首先，在你的LocalContainerEntityManagerFactoryBean配置中添加持久化单元名称：

@Bean
EntityManagerFactory appEntityManagerFactory(){
    LocalContainerEntityManagerFactoryBean emf = new LocalContainerEntityManagerFactoryBean();
    emf.setDataSource(dataSourceApp());
    emf.setJpaVendorAdapter(jpaVendorAdaptor);
    emf.setPersistenceUnitName("appPersistenceUnit"); // 新增持久化单元标识
    emf.afterPropertiesSet();
    return emf.getObject();
}

然后在业务类中用@PersistenceContext注入EntityManager，Spring会自动管理它的生命周期（包括连接的获取与归还）：

@PersistenceContext(unitName = "appPersistenceUnit")
private EntityManager entityManager;

// 业务方法中直接使用
public void handleRequest(String queryString) {
    Query query = entityManager.createNativeQuery(queryString);
    ExecuteQueries(query, queryString);
}

2. 手动管理EntityManager时，确保每次使用都创建新实例并关闭 #

如果必须手动控制EntityManager的创建，绝对不要用单例Bean，而是每次需要时从EntityManagerFactory获取新实例，并在finally块中确保关闭：

@Autowired
private EntityManagerFactory appEntityManagerFactory;

public void handleRequest(String queryString) {
    EntityManager entityManager = null;
    try {
        entityManager = appEntityManagerFactory.createEntityManager();
        Query query = entityManager.createNativeQuery(queryString);
        ExecuteQueries(query, queryString);
    } finally {
        if (entityManager != null && entityManager.isOpen()) {
            entityManager.close(); // 这里会真正释放连接回池
        }
    }
}

3. 检查事务与HikariCP配置的配合 #

• 如果你在业务方法上使用了@Transactional注解，连接会被事务持有直到事务提交/回滚，此时不需要手动关闭EntityManager，Spring会自动处理连接归还。
• 你的HikariCP配置中maxLifetime=130000（130秒）短于validationTimeout=300000是合理的，但如果连接被EntityManager持续占用，HikariCP无法强制回收被使用的连接，所以核心还是要解决EntityManager的生命周期问题。

额外建议：尽量使用Spring Boot的自动配置 #

Spring Boot对JPA和HikariCP有完善的自动支持，除非有特殊需求，建议移除自定义的dataSourceApp、appEntityManagerFactory等Bean，直接通过application.properties配置：

# DB2基础配置
spring.datasource.url=your-db2-url
spring.datasource.username=xxx
spring.datasource.password=xxx
spring.datasource.driver-class-name=com.ibm.db2.jcc.DB2Driver

# HikariCP连接池配置
spring.datasource.hikari.minimum-idle=0
spring.datasource.hikari.idle-timeout=120000
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.connection-timeout=300000
spring.datasource.hikari.max-lifetime=130000
spring.datasource.hikari.validation-timeout=300000

这样Spring会自动帮你创建正确的DataSource、EntityManagerFactory和EntityManager，避免手动配置带来的生命周期管理问题。

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