最大等待时间指线程获取数据库连接时的最长排队时限，超时抛异常；HikariCP用connection-timeout（默认30s），Druid用max-wait（默认60s），需据业务场景设为5–30秒并配合监控与泄漏排查。
最大等待时间（Max Wait Time）是指当应用请求数据库连接时，连接池中没有空闲连接可用，线程必须等待其他连接被归还的最长时间。超时未获取到连接会直接抛异常，比如 HikariCP 的 Connection acquisition timeout 或 Druid 的 maxWait 超时错误。它不控制连接本身寿命，而是控制“排队等连接”的容忍度。
不同连接池对应的最大等待时间参数名
各主流连接池使用不同名称，但语义一致：
-
HikariCP：
connection-timeout（单位：毫秒），默认 30000（30 秒） -
Druid：
max-wait（单位：毫秒），默认 60000（60 秒） -
DBCP2：
max-wait-millis（单位：毫秒），默认 -1（无限等待，不推荐） -
C3P0：
checkoutTimeout（单位：毫秒）
合理设置值的关键依据
这个值不是越大越好，需平衡业务容忍度与故障暴露速度：
- 常规 Web 接口建议设为 10000～30000 毫秒（10～30 秒）；短链路或高实时性场景可压至 5000 毫秒
- 若业务本身有长耗时操作（如报表导出），应避免靠拉长等待时间来掩盖问题，而应单独建专用小池或异步处理
- 值设得过长会导致线程堆积、响应雪崩；设得太短则容易误报，掩盖真实瓶颈（如慢 SQL 或连接泄漏）
- 线上建议配合监控：观察
activeConnections、threadsAwaitingConnection等指标，确认是否频繁触达等待上限
Spring Boot 中典型配置示例
以 application.yml 为例，直接写入即可生效，无需额外代码：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
spring:
datasource:
hikari:
connection-timeout: 20000
maximum-pool-size: 20
minimum-idle: 5
Druid 配置类似：
spring:
datasource:
druid:
max-wait: 20000
initial-size: 5
max-active: 20
注意：该参数只影响“获取连接”阶段，不影响连接建立后的 SQL 执行时长；查询超时需另行配置 query-timeout 或 JDBC URL 中的 socketTimeout。
配套必须检查的几件事
单设最大等待时间不够，需同步排查和配置：
- 确认是否存在连接未关闭（即连接泄漏）：检查所有
getConnection()是否都有对应close()或使用 try-with-resources - 检查
maximum-pool-size是否明显小于并发峰值需求，比如 QPS=100、平均响应 200ms，则理论需至少 20 个活跃连接，再留余量 - 验证数据库侧资源是否充足：
show status like 'Threads_connected';是否接近max_connections - 开启连接池健康监控（如 HikariCP 的
/actuator/metrics/hikaricp.connections.active）便于定位是池子小了，还是连接卡死了
