Spring Boot中HikariCP配置后RDS连接数超预期的问题排查

核心原因推测 #

从你的Hikari日志里能看到HikariPool-13、HikariPool-14多个连接池实例——这是导致RDS连接数远超单个池配置上限的最可能原因。每个Hikari池都会独立创建并维护自己的数据库连接，多个池的连接数加起来自然会突破你设置的maximum-pool-size=20限制。

除此之外，还有两个次要可能：

• 连接关闭的网络延迟：Hikari已经标记连接关闭，但由于网络或MySQL的TCP连接回收机制（比如TIME_WAIT状态），RDS端还没彻底释放这些连接，导致统计数偏高。
• 短生命周期的连接池：如果应用频繁重启或者动态创建销毁连接池，旧池的连接可能没被正常关闭，在RDS端残留为无效连接。

具体排查与修复步骤 #

1. 确认并合并多个连接池实例 #

• 检查代码中是否手动创建了多个DataSource Bean，或者存在多个@Configuration类重复初始化数据源。Spring Boot默认会自动配置一个数据源，除非你手动覆盖，否则不需要额外创建。
• 排查第三方依赖（比如监控工具、多租户框架）是否偷偷创建了额外的连接池。可以通过打印Spring上下文里的所有DataSource Bean来确认：

@Autowired
private ApplicationContext context;

public void listDataSources() {
    Map<String, DataSource> dataSources = context.getBeansOfType(DataSource.class);
    dataSources.forEach((name, ds) -> {
        if (ds instanceof HikariDataSource) {
            HikariDataSource hikariDs = (HikariDataSource) ds;
            System.out.println("连接池名称：" + name + "，最大连接数：" + hikariDs.getMaximumPoolSize());
        }
    });
}

• 确保所有数据库操作都使用同一个数据源，删除不必要的手动数据源配置。

2. 优化连接生命周期配置 #

你的max-lifetime=50000（50秒）设置过短，会导致Hikari频繁销毁重建连接，反而容易出现连接残留。建议调整为RDS wait_timeout参数的80%（RDS默认wait_timeout是28800秒，即8小时），比如设置为：

spring.datasource.hikari.max-lifetime=23040000

同时，确保idle-timeout小于max-lifetime，避免配置冲突。

3. 验证连接状态与回收 #

• 登录RDS控制台，执行SHOW PROCESSLIST查看所有连接的状态、来源IP，确认哪些连接是你的应用创建的。如果发现大量Sleep状态的连接，且来源是应用服务器，说明这些是Hikari已经标记关闭但RDS还没回收的连接。
• 观察Hikari的DEBUG日志，查看连接关闭时是否有异常提示，比如关闭失败的报错信息。

4. 确保应用重启时正常关闭连接 #

• 检查应用关闭流程，确保Spring上下文正常销毁，Hikari池的close()方法被调用。可以通过添加销毁钩子强制关闭数据源：

@PreDestroy
public void shutdownDataSource() {
    DataSource dataSource = context.getBean(DataSource.class);
    if (dataSource instanceof HikariDataSource) {
        ((HikariDataSource) dataSource).close();
    }
}

验证效果 #

修复后，观察Hikari日志是否只有单个编号的连接池实例（比如HikariPool-1），同时监控RDS的连接数，确认其稳定在单个池的maximum-pool-size范围内。

内容的提问来源于stack exchange，提问作者Khaled El Attar