Java数据库连接超时需分三层设置：1. JDBC URL中connectTimeout（建连超时，毫秒）和socketTimeout（读写超时）；2. 驱动级setLoginTimeout（秒，常被URL参数覆盖）；3. 连接池（如HikariCP）的connection-timeout、idle-timeout与max-lifetime等参数协同控制获取、空闲及生命周期超时。
Java 中数据库连接超时时间不能只靠代码“硬编码设置”，而是通过 JDBC 连接 URL 参数、DataSource 配置或连接池（如 HikariCP、Druid）的专属属性来控制。核心是区分三种超时：连接建立超时（connection timeout）、登录认证超时（login timeout）、以及连接空闲/租用超时（idle/lease timeout）。下面按实际使用场景说明关键设置方式。
1. JDBC URL 中设置连接建立超时（connectTimeout）
这是最基础的超时，指客户端尝试与数据库服务器建立 TCP 连接的最大等待时间。仅对 DriverManager.getConnection() 或部分 DataSource 生效，且依赖驱动支持（MySQL、PostgreSQL 均支持）。
示例（MySQL）：
String url = "jdbc:mysql://localhost:3306/mydb?connectTimeout=3000&socketTimeout=30000";
Connection conn = DriverManager.getConnection(url, user, pwd);
-
connectTimeout=3000：单位毫秒，3 秒内连不上就抛
SQLException - socketTimeout=30000：非连接超时，而是查询执行过程中网络读写的最大等待时间（防止 long query 卡死）
2. 使用 setLoginTimeout() 设置驱动级登录超时
该方法由 java.sql.Driver 提供，影响所有通过此 Driver 创建的连接，但实际效果受限于驱动实现（很多现代驱动已忽略它，优先以 URL 参数为准）。
示例：
Driver driver = new com.mysql.cj.jdbc.Driver();driver.setLoginTimeout(5); // 单位：秒
Connection conn = driver.connect(url, props);
- 设置的是整个登录流程（DNS 解析 + TCP 握手 + 认证）的上限
- 若已用 URL 指定了
connectTimeout，该调用可能被覆盖或不生效
3. 连接池中设置更实用的超时参数（推荐）
生产环境几乎都用连接池（如 HikariCP），其超时控制更全面、稳定，且与 Spring Boot 等框架集成友好。
HikariCP 示例（application.yml）：
spring:datasource:
hikari:
connection-timeout: 3000 # 获取连接的最大等待时间（池中无空闲连接时）
validation-timeout: 3000 # 连接校验超时（如 test-on-borrow）
idle-timeout: 600000 # 连接在池中最大空闲时间（默认 10 分钟）
max-lifetime: 1800000 # 连接最大存活时间（避免 DB 主动断连）
connection-init-sql: "SET NAMES utf8mb4"
-
connection-timeout是你最常要调的——应用从连接池getConnection()时，等不到空闲连接就会在此超时后报错 -
idle-timeout和max-lifetime防止连接因长时间空闲或老化被 DB 关闭，引发后续通信异常
4. 注意事项与常见误区
- JDBC URL 中的
connectTimeout只管建连，不管 SQL 执行；SQL 超时需用Statement.setQueryTimeout()或框架（如 MyBatis 的timeout属性）单独设 - Spring 的
@Transactional(timeout = 30)控制的是事务整体执行时间，不是数据库连接获取时间 - Docker 或云数据库（如阿里云 RDS）可能有中间代理层，其自身连接空闲超时（如 300 秒）会强杀连接，此时光调 Hikari 的
max-lifetime不够，还需匹配 DB 层配置
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
