配置最大等待时间需要设置连接池获取连接的超时参数,通常单位为毫秒。以常见的 hikaricp 为例,通过 setconnectiontimeout() 方法指定等待时间;若使用 druid,则通过 maxwait 属性配置。该值决定了当所有连接都被占用时,请求线程最多愿意等待多久,超时后将抛出异常。

HikariCP 中如何设置连接超时
在 HikariCP 中,通过 setConnectionTimeout(long timeoutMillis) 方法配置最大等待时间。默认值为 30000 毫秒(30秒)。如果在此时间内无法获得连接,将抛出 SQLException。建议根据业务场景调整此值,避免过短导致频繁失败或过长导致资源堆积。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
public class HikariExample {
public static void main(String[] args) {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/testdb");
config.setUsername("user");
config.setPassword("pass");
// 设置最大等待时间为5秒
config.setConnectionTimeout(5000);
HikariDataSource ds = new HikariDataSource(config);
System.out.println("Connection timeout set to: " + config.getConnectionTimeout() + " ms");
}
}
Druid 连接池中的 maxWait 配置
在 Druid 中,通过 maxWait 属性设置获取连接的最大等待时间,单位也是毫秒。默认值为 -1,表示无限等待。设置为正数后,若在指定时间内未获得连接,将抛出 SQLException。该配置适用于 Spring Boot 集成 Druid 的场景。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import com.alibaba.druid.pool.DruidDataSource;
import java.sql.Connection;
public class DruidExample {
public static void main(String[] args) throws Exception {
DruidDataSource dataSource = new DruidDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/testdb");
dataSource.setUsername("user");
dataSource.setPassword("pass");
// 设置最大等待时间为10秒
dataSource.setMaxWait(10000);
Connection conn = dataSource.getConnection();
System.out.println("Got connection with maxWait: " + dataSource.getMaxWait());
conn.close();
}
}
当连接池耗尽且超过等待时间时会发生什么
当连接池中的所有连接都被占用,且新请求超过了设定的最大等待时间,连接池会拒绝获取连接并抛出 SQLException。例如,在 HikariCP 中抛出的是 java.sql.SQLTransientConnectionException,提示“Connection is not available, request timed out after XXXms”。开发者应在代码中捕获该异常并进行适当处理,如重试、降级或返回错误响应。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










