Hikari设置minimumIdle未生效，实际Postgres连接数远低于配置值

1. 配置有效性校验 #

• 硬编码的Hikari配置需要确认已实际绑定到运行的数据源实例：程序初始化后可调用HikariPool.getMinimumIdle()、HikariPool.getMaximumPoolSize()打印运行时参数，确认返回值和你设置的20、100一致。
• 若使用Spring/SpringBoot框架，需排查框架自动装配的HikariDataSource是否覆盖了你的自定义配置：SpringBoot2+默认读取spring.datasource.hikari.*配置项加载连接池，若自定义config没有替换自动装配的实例，配置不会生效。

2. 空闲连接初始化逻辑适配 #

Hikari不会在服务启动时直接创建满minimumIdle数量的连接，仅当有数据库请求触发连接获取、且当前空闲连接数低于minimumIdle阈值时，才会创建新连接补充到配置值。服务启动后无数据库请求的场景下，默认只会初始化1~2个必要连接，符合你观测到的现象。
如果需要启动时就初始化足够的空闲连接，可通过以下两种方式实现：

• 添加配置config.setInitializationFailTimeout(-1);，配合minimumIdle配置实现启动预创建连接
• 服务启动后主动执行一次hikariDataSource.getConnection().close()，触发一次连接获取流程，即可自动填充空闲连接到minimumIdle指定数量

3. 连接创建失败场景排查 #

• 检查Postgres服务端max_connections配置，若数据库允许的总连接数已达上限，Hikari无法创建新连接：可在Postgres控制台执行show max_connections;查看当前上限。
• 查看程序运行日志，排查是否存在连接创建超时、数据库账号权限不足、防火墙/安全组拦截导致连接建立失败的异常。
• 检查服务端操作系统的文件句柄限制、临时端口范围限制，确认没有系统层面的规则阻止建立更多到5432端口的TCP连接。

4. 连接数查询逻辑校验 #

• 执行netstat查询时需过滤正确的连接状态，已建立的业务连接状态为ESTABLISHED，可使用命令netstat -ant | grep ESTABLISHED | grep 5432统计，避免统计到TIME_WAIT等非可用状态的连接。
• 执行SELECT sum(numbackends) FROM pg_stat_database;查询时建议使用Postgres超级用户执行，避免普通账号权限不足导致连接数统计不全。

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