配置连接池租户连接的存活时间,核心在于设置连接的生命周期检测与清理策略。以常见的 druid 连接池为例,需要开启后台线程对空闲连接进行定期校验,并设定最大存活时长(maxlifetime),确保超过该时间的连接被强制关闭并替换。这样做可以防止数据库服务端主动断开长期闲置的连接,从而避免应用层获取到“死连接”导致 sqlexception。

Druid 连接池如何配置 maxLifetime 和 keepAlive
在 Druid 中,必须同时配置 maxLifetime 和 keepAliveInterval 才能有效管理连接存活时间。maxLifetime 定义了连接的最大生命周期(毫秒),超过此时间的连接会被销毁;keepAliveInterval 则定义了在连接被回收前,后台线程多久执行一次心跳检测,用于保持连接活跃或提前发现断开的连接。这两个参数需配合 keepAliveEnable=true 使用。

import com.alibaba.druid.pool.DruidDataSource;
public class DruidConfig {
public static DruidDataSource createDataSource() {
DruidDataSource dataSource = new DruidDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/test");
dataSource.setUsername("root");
dataSource.setPassword("password");
// 设置连接最大存活时间:30分钟 (1800000 ms)
dataSource.setMaxLifetime(1800000);
// 开启 KeepAlive 功能
dataSource.setKeepAlive(true);
// 设置 KeepAlive 检测间隔:5分钟 (300000 ms)
// 这个间隔应小于 maxLifetime,且通常建议为 maxLifetime 的 1/3 到 1/2
dataSource.setKeepAliveInterval(300000);
// 最小空闲连接数,确保 KeepAlive 线程有连接可检测
dataSource.setMinIdle(5);
return dataSource;
}
}
运行上述代码后,Druid 会启动一个守护线程。如果某个连接创建时间超过 1800000 毫秒,它将被标记为无效并从池中移除。同时,每 300000 毫秒,后台线程会对至少 minIdle 数量的空闲连接发送心跳包(如 SELECT 1),若连接已断开则重新建立。这确保了池中的连接始终是有效的且未超龄。
HikariCP 如何配置 connectionTimeout 和 maxLifetime
HikariCP 的配置更为简洁,主要依赖 maxLifetime 参数。HikariCP 默认启用了类似 KeepAlive 的机制,当连接接近 maxLifetime 时,它会主动关闭并替换连接,无需单独设置心跳间隔。但需注意,connectionTimeout 控制的是获取连接的超时时间,而非连接本身的存活时间,两者概念不同。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
public class HikariConfigExample {
public static HikariDataSource createDataSource() {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/test");
config.setUsername("root");
config.setPassword("password");
// 设置连接最大存活时间:30分钟 (1800000 ms)
// HikariCP 推荐值比数据库的 wait_timeout 稍短
config.setMaxLifetime(1800000);
// 获取连接的超时时间:30秒 (30000 ms)
// 这不是连接存活时间,而是等待可用连接的超时
config.setConnectionTimeout(30000);
// 最小空闲连接数
config.setMinimumIdle(5);
return new HikariDataSource(config);
}
}
在此配置下,HikariCP 会在连接即将达到 1800000 毫秒寿命时,由后台线程将其关闭并创建新连接。由于 HikariCP 默认行为是“懒加载”且高效的心跳检测,通常不需要额外配置类似 Druid 的 keepAliveInterval。只要 maxLifetime 设置合理,即可保证连接的有效性。
当 maxLifetime 设置为 0 或未设置时会发生什么
如果在 Druid 中未设置 maxLifetime 或将其设为 0,连接将不会因年龄而被自动回收,除非连接变为无效(如网络中断)。在 HikariCP 中,maxLifetime 默认值为 1800000 毫秒(30分钟),若显式设为 0 或负数,则连接永远不会因生命周期原因被回收。这两种情况都可能导致连接成为“僵尸连接”,即数据库端已断开但应用端仍认为连接有效,最终在使用时抛出异常。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











