java中数据库连接超时由jdbc驱动自动抛出sqltimeoutexception或sqlexception，应捕获后封装为自定义异常（如databaseconnectiontimeoutexception），保留cause链，并通过连接池配置（如hikaricp的connectiontimeout）和url参数（如connecttimeout）协同控制超时行为。
Java 中数据库连接超时本身会由 JDBC 驱动自动抛出标准异常（如 java.sql.SQLTimeoutException 或 java.sql.SQLException），而不是直接抛出自定义异常。但你可以在捕获这些底层异常后，**封装并重新抛出你自己的自定义异常**，以统一业务语义、增强可读性或适配上层异常处理策略。
1. 定义自定义异常类
继承 RuntimeException（运行时异常，无需强制 try-catch）或 Exception（检查型异常，调用方必须处理）：
public class DatabaseConnectionTimeoutException extends RuntimeException {
public DatabaseConnectionTimeoutException(String message) {
super(message);
}
public DatabaseConnectionTimeoutException(String message, Throwable cause) {
super(message, cause);
}
}
2. 在获取连接时捕获超时异常并转换
JDBC 连接超时通常发生在 DriverManager.getConnection() 或连接池（如 HikariCP、Druid）的 dataSource.getConnection() 调用中。部分驱动支持设置连接超时（如 MySQL 的 connectTimeout 参数），超时后会抛出 SQLTimeoutException 或带特定 SQLState/错误码的 SQLException。
推荐做法：在工具类或 DAO 层封装连接逻辑，统一转换异常：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 检查原始异常是否为
SQLTimeoutException，或通过sqlState（如 "08S01"）、错误码（如 MySQL 的 1042）、消息关键词（如 "Connection timed out"）识别超时场景 - 捕获后包装为你的自定义异常，并保留原始异常作为 cause，便于排查根因
- 避免吞掉异常或仅打印日志而不抛出——否则上层无法感知连接失败
public Connection getConnection() throws DatabaseConnectionTimeoutException {
try {
return dataSource.getConnection(); // 或 DriverManager.getConnection(...)
} catch (SQLTimeoutException e) {
throw new DatabaseConnectionTimeoutException("数据库连接超时，请检查网络或数据库服务状态", e);
} catch (SQLException e) {
// 可选：根据驱动特性进一步判断是否属于连接超时
if ("08S01".equals(e.getSQLState()) || e.getMessage().toLowerCase().contains("timeout")) {
throw new DatabaseConnectionTimeoutException("数据库连接异常（疑似超时）", e);
}
throw new RuntimeException("数据库访问异常", e); // 其他 SQLException 转为通用异常
}
}
3. 使用连接池时注意配置超时参数
自定义异常能否被准确触发，依赖于底层是否真正抛出了超时信号。务必在数据源配置中启用并合理设置连接获取超时：
-
HikariCP：设置
connection-timeout（默认 30s），超时会抛HikariPool.PoolInitializationException或SQLException，需捕获并识别 -
Druid：配置
maxWait（获取连接最大等待时间），超时抛SQLException，消息含 "wait millis" 关键词 -
MySQL JDBC URL：添加
&connectTimeout=5000&socketTimeout=30000，前者控制 TCP 建连超时，后者控制查询执行超时（注意：connectTimeout 触发的是CommunicationsException，需单独判断）
4. 上层调用与统一异常处理
抛出自定义异常后，可在 Spring 等框架中配合 @ControllerAdvice 统一响应错误码和提示，例如：
@ExceptionHandler(DatabaseConnectionTimeoutException.class)
public ResponseEntity<errorresponse> handleConnectionTimeout(DatabaseConnectionTimeoutException e) {
return ResponseEntity.status(503).body(new ErrorResponse("DB_UNAVAILABLE", e.getMessage()));
}</errorresponse>
这样前端或调用方看到的是清晰、可分类的业务错误，而非晦涩的 JDBC 异常栈。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
