Spring Boot中HikariPool管家线程未关闭致进程无法退出求助

在Spring Boot应用中配置了两个Hikari DataSource，Bean定义如下：

@Primary
@Bean(value="appDataSource",destroyMethod="close")
@ConfigurationProperties("app.db.datasource")
@Override
public DataSource dataSource() {
    return DataSourceBuilder.create().build(); 
}

@Bean(value="pacsDataSource",destroyMethod="close")
@Override
public DataSource dataSource() {
    return new HikariDataSource(hikariConfig());
}

问题现象 #

应用关闭时，日志中出现[HikariPool-1 housekeeper]和[HikariPool-2 housekeeper]线程未停止的警告，提示可能造成内存泄漏，且Java进程无法正常退出。理论上Spring容器销毁时应调用close()方法终止连接池线程，但实际未生效。另外相同Jar包在部分环境下无此问题，正排查环境差异。

核心问题分析 #

1. 方法名冲突：两个DataSource Bean的方法签名完全相同（均为@Override public DataSource dataSource()），Spring容器无法正确区分和注册两个独立Bean，会引发初始化或销毁逻辑混乱。
2. 数据源类型模糊：第一个数据源通过DataSourceBuilder.create().build()创建，未明确指定类型为HikariDataSource，Spring可能无法识别其销毁逻辑，导致close()方法未被触发。
3. 线程引用持有：部分环境下第三方组件（如监控Agent、自定义线程池）可能持有Hikari线程的引用，阻止线程被GC回收，导致进程无法退出。

解决方案 #

1. 修正方法名冲突：将两个Bean的方法名改为唯一标识，确保Spring能正确注册不同数据源：

   @Primary
   @Bean(value="appDataSource", destroyMethod="close")
   @ConfigurationProperties("app.db.datasource")
   public HikariDataSource appDataSource() {
       return DataSourceBuilder.create().type(HikariDataSource.class).build(); 
   }
   
   @Bean(value="pacsDataSource", destroyMethod="close")
   public HikariDataSource pacsDataSource() {
       return new HikariDataSource(hikariConfig());
   }
   

2. 明确指定数据源类型：第一个数据源通过type(HikariDataSource.class)明确类型，确保Spring能识别并执行Hikari的销毁逻辑。
3. 检查Hikari配置：确认hikariConfig()中的参数设置，避免keepaliveTime、minimumIdle等参数导致线程长期存活；确保autoCommit、connectionTimeout等参数配置合理。
4. 验证容器关闭逻辑：确保应用通过正常方式关闭（如发送SIGINT信号、调用SpringApplication.exit()），避免强制杀死进程；检查是否存在自定义ShutdownHook干扰Spring的销毁流程。
5. 排查环境差异：对比异常与正常环境的以下内容：
   • JVM版本、启动参数
   • Spring Boot及HikariCP的版本
   • 系统内核参数、资源限制
   • 是否存在监控Agent或调试工具

内容的提问来源于stack exchange，提问作者The Shoe Shiner