spring boot 数据库连接超时治理需三层面协同：调优hikaricp参数（connection-timeout、max-lifetime等）、配置jdbc底层超时（connecttimeout/sockettimeout）、定制sqlexceptiontranslator区分异常语义，并辅以连接验证与保活机制。
Spring Boot 中处理数据库连接超时异常，核心思路是“预防为主、捕获为辅、分级响应”——不能只靠 try-catch 抓异常，而要从连接池配置、JDBC 参数、异常语义识别三层面协同治理。
调优 HikariCP 连接池关键参数
连接超时大多发生在获取连接阶段，HikariCP 的 connection-timeout 是第一道防线。默认 30 秒对高延迟网络或负载高峰明显不足：
- spring.datasource.hikari.connection-timeout=60000：设为 60 秒，给跨机房/云厂商网络留出余量
- spring.datasource.hikari.max-lifetime=1800000（30 分钟）：避免连接存活过久被 MySQL 主动断开（默认 wait_timeout=28800 秒即 8 小时，但中间设备可能更激进）
- spring.datasource.hikari.validation-timeout=3000：连接校验超时需短于 connection-timeout，防止校验本身拖慢获取流程
- spring.datasource.hikari.idle-timeout=600000（10 分钟）：空闲连接回收时间，建议略小于 MySQL 的 wait_timeout，主动清理而非被动失效
在 JDBC URL 中嵌入底层超时控制
HikariCP 管的是“从池里拿连接”，而真正建连和读取由 MySQL 驱动控制。必须在 datasource.url 中显式声明：
- connectTimeout=5000：TCP 建连阶段超时，防 DNS 解析慢或防火墙拦截
- socketTimeout=60000：建立连接后，读写数据的单次操作超时（如执行一条 SQL 卡住）
- useSSL=false&allowPublicKeyRetrieval=true：避免 SSL 握手耗时引发误判（生产环境应启用 SSL 并配可信证书）
示例完整 URL：
jdbc:mysql://db-prod-east:3306/myapp?useSSL=false&allowPublicKeyRetrieval=true&connectTimeout=5000&socketTimeout=60000
定制 SQLExceptionTranslator 区分可恢复与不可恢复异常
默认异常翻译器把所有连接失败都转成 500，无法指导前端重试或运维告警。需自定义 SQLExceptionTranslator 实现类并标记 @Primary：
- 递归遍历 getCause() 链，定位原始驱动异常（如
CommunicationsException、SocketTimeoutException） - 对网络类异常（如 MySQL 的
ERRNO 110、Oracle 的ORA-12545）返回 HTTP 503，提示“服务暂时不可用，建议重试” - 对配置类错误（如连接串写错端口、用户无权限）返回 400，避免盲目重试
- 不覆盖全部异常，返回 null 让默认翻译器兜底，保持兼容性
补充防护：连接有效性验证 + 定期探活
仅靠超时参数不能解决“连接已断但池未感知”问题（如 MySQL kill 连接、网络闪断）：
- 启用 connection-test-query（MySQL 推荐
SELECT 1），配合 validation-timeout 控制校验耗时 - 设置 spring.datasource.hikari.keepalive-time=30000（HikariCP 3.2.1+），每 30 秒向空闲连接发保活包
- 在应用启动和配置刷新时，执行一次
HikariDataSource.getConnection().close()主动触发初始连接测试
