3、连接池耗尽异常定义

连接池耗尽异常是中间件集成层最常遇到的资源枯竭型故障。当应用程序向连接池请求连接的速度超过池子回收与释放的速度时，所有连接被占满，新的请求无法获取可用连接，便会触发此异常。理解其定义、表现形式与堆栈特征，是定位和预防该问题的第一步。

3.1 什么是连接池耗尽异常

连接池耗尽（Connection Pool Exhaustion）是指连接池中所有连接均处于“已分配”状态，且已达到最大连接数上限，此时任何新的 getConnection() 调用都会立即失败或阻塞超时。该异常本质上是一种资源耗尽问题，而非代码语法错误。

3.2 异常的表现形式

连接池耗尽在不同中间件和配置下，会呈现三种典型的表现形式。开发与运维人员需要根据具体症状快速定位问题类型。

1. 立即失败（Fail-Fast）：连接池在调用 getConnection() 时直接抛出异常，不等待。常见于 HikariCP 默认配置。
2. 阻塞超时（Blocking Timeout）：调用方等待指定时间（如 connectionTimeout=30000ms）后仍未获取连接，抛出超时异常。常见于 DBCP、Tomcat JDBC Pool。
3. 应用无响应（Hang）：连接池未设置超时或超时时间过长，线程永久阻塞，最终导致线程池耗尽，应用整体假死。

3.3 常见异常堆栈解读

不同连接池中间件抛出的异常堆栈各有特征。掌握堆栈中的关键字段，可以快速判断是哪种连接池耗尽以及耗尽发生的阶段。下表列出三种主流连接池的典型异常堆栈片段。

以下是一个 HikariCP 耗尽异常的完整堆栈示例，标注了关键信息位置：

java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available,
  request timed out after 30000ms.                          ← 超时时间 30 秒
    at com.zaxxer.hikari.pool.HikariPool.createTimeoutException(HikariPool.java:696)
    at com.zaxxer.hikari.pool.HikariPool.getConnection(HikariPool.java:197)
    at com.zaxxer.hikari.pool.HikariPool.getConnection(HikariPool.java:150)
    at com.zaxxer.hikari.HikariDataSource.getConnection(HikariDataSource.java:128)
    at org.springframework.jdbc.datasource.DataSourceUtils.fetchConnection(DataSourceUtils.java:158)
    ... 省略业务调用栈 ...
Caused by: java.util.concurrent.TimeoutException:                              ← 内部超时异常
    at java.base/java.util.concurrent.CompletableFuture.timedGet(CompletableFuture.java:1960)
    ... 省略 ...
HikariPool-1 - Pool stats (total=20, active=20, idle=0, waiting=12)           ← 关键状态快照
  total=20: 池总大小
  active=20: 全部活跃，无空闲
  idle=0:   空闲连接为 0
  waiting=12: 12 个线程在等待连接

解读堆栈时，重点关注以下三个信息：

• 异常类名：SQLTransientConnectionException（HikariCP）或 PoolExhaustedException（Tomcat Pool），直接指明连接池问题。
• 超时时间：timed out after 30000ms，反映连接池 connectionTimeout 配置值。
• 池状态快照：active=20, idle=0, waiting=12，这是诊断耗尽的黄金证据——活跃数等于最大连接数，空闲为 0，等待队列非空。