如何配置Hikari连接池实现初始0连接且空闲时自动缩容至0

你遇到的每个连接池残留1个连接的问题，通常是版本bug、参数依赖逻辑不满足、回收等待周期未到导致的，按以下步骤调整即可实现无业务需求时连接池完全缩容到0：

调整配置步骤 #

1. 确认HikariCP版本 #

低于3.0.0的HikariCP存在已知bug：当minimumIdle设为0时，即使所有连接空闲超时仍会残留1个空闲连接，直接升级到3.0.0及以上版本即可修复该问题。

2. 补全依赖配置 #

仅设置minimumIdle=0无法满足缩容要求，需要保证以下参数的取值逻辑符合规则：

// 原有基础配置保留
hikariConfig.setMinimumIdle(0);
hikariConfig.setMaximumPoolSize(10);
hikariConfig.setIdleTimeout(180000); // 空闲超时时间3分钟，可按需调整，最小允许值为10000毫秒

// 新增必要配置
hikariConfig.setMaxLifetime(240000); // 连接最大生命周期，必须大于 idleTimeout + 30秒（默认后台扫描间隔）
hikariConfig.setKeepaliveTime(0); // 关闭空闲连接心跳检测，避免心跳请求导致连接被判定为非空闲状态

// 可选配置：如果需要更快触发回收，可缩小后台扫描间隔，默认30000毫秒，不建议低于10000毫秒
// hikariConfig.setHousekeepingPeriodMs(10000);

3. 等待回收周期生效 #

HikariCP的空闲连接回收不是实时触发，由后台Housekeeping线程定时扫描处理，最后一个连接的最长回收等待时间为：idleTimeout配置值 + 后台扫描间隔。比如使用默认30秒扫描间隔+3分钟空闲超时的场景，最长需要3分30秒才会完全回收所有连接，等待周期结束后再执行show processlist验证即可。

常见误区说明 #

• 不要把idleTimeout设置为小于10000毫秒，低于该值时HikariCP会自动修正为10分钟，导致配置不生效
• 如果是集成SpringBoot使用，要确认配置文件没有覆盖代码中设置的minimumIdle参数，优先在SpringBoot配置文件中统一配置所有Hikari参数
• show processlist中状态为Sleep的连接属于空闲连接，不属于活跃业务连接，超时后会自动被回收

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