Druid连接池心跳与空闲连接回收配置指南

文章目录

数据源配置

数据源配置

问题背景：

长期运行的应用在低峰期可能出现部分业务请求报 SQL 执行超时或类似 The last packet successfully received from the server was xxx milliseconds ago. 的连接异常，但瞬间重试又能正常访问。这个现象常见于连接被远端或中间网络设备（如防火墙/NAT）关闭或回收后未及时重连导致的错误

问题原因：

默认超时机制：数据库如Mysql存在超时机制，若连接空闲超过一段时间（可设置），数据库主动关闭连接，导致客户端请求时异常。
防火墙/NAT会话超时：中间网络设备可能设置更短的TCP会话超时（如30分钟），也会导致连接失效。

解决方式：

推荐配置：

在 jdbc.yml 的数据源配置中加入心跳与空闲连接回收相关配置，可以显著降低此类错误：

xml 复制代码

url: jdbc:xxx://ip:port/dbname?param1=xx1&param2=xx2 #jdbc url连接配置
driverClassName: com.goldendb.jdbc.Driver #国产数据库驱动按需要配置
username: xxx 
password: xxx
initialSize: 2 #连接池初始化大小,根据业务场景配置，默认0
minIdle: 2     #连接池最小空闲连接数,根据业务场景配置，默认0 
maxActive: 32#连接池最大连接数,根据业务场景配置，默认8
maxWait: 60000  #连接池最大等待时间,根据业务场景配置，默认-1无限制
keepAlive: true #是否开启连接心跳保活,默认false
validationQuery: SELECT 1 FROM DUAL #心跳是用的sql,默认不配置，会根据driverClassName来自动配置，mysql是SELECT 1  oracle是 SELECT 1 FROM DUAL ， 也可以使用查询业务空表来做心跳
minEvictableIdleTimeMillis: 300000 #空闲5分钟以上的连接被移除,但会保留minIdle配置的连接数不进行移除, 默认30分钟
maxEvictableIdleTimeMillis: 1800000 #空闲30分钟以上的连接被移除，与minIdle无关, 默认7小时

关键项说明：

xml 复制代码

keepAlive: true # 开启连接心跳；是否开启连接心跳保活，默认false
validationQuery # 心跳/校验语句

空闲回收策略是解决问题的核心

xml 复制代码

minEvictableIdleTimeMillis # 最小空闲连接时间
maxEvictableIdleTimeMillis # 最大空闲连接时间

1、keepAlive 打开后，连接池会定期执行 validationQuery 检测连接是否可用，遇到不可用连接会回收并重建。

2、validationQuery 根据数据库类型选择（MySQL 常用 SELECT 1，Oracle 常用 SELECT 1 FROM DUAL），也可以用一个查询空表的业务语句作为心跳。

3、minEvictableIdleTimeMillis/maxEvictableIdleTimeMillis 控制空闲连接何时被回收：合理设置能在保证性能的同时避免长期空闲连接被底层网络/数据库回收导致的问题。