连接池耗尽，WMS 集体 503

现象

GeoServer 日志连续出现等待连接超时，之后所有请求失败：

ERROR [geoserver.wms] -
org.geoserver.platform.ServiceException: Rendering process failed.
Caused by: org.apache.commons.dbcp2.ConnectionPoolTimeoutException:
  Timeout waiting for connection from pool
    at org.apache.commons.dbcp2.Datasource.waitForConnection(Datasource.java:1305)

HTTP/1.1 503 Service Unavailable
Retry-After: 120

数据库侧 pg_stat_activity 显示连接数顶到 max_connections。

原因

排查过程

先在数据库侧看连接来源与状态，再回到 GeoServer 看池配置：

SELECT usename, state, count(*)
FROM pg_stat_activity
GROUP BY usename, state
ORDER BY count(*) DESC;

SELECT pid, now() - query_start AS duration, query
FROM pg_stat_activity
WHERE state = 'active' AND now() - query_start > interval '30 seconds';

GeoServer 侧打开连接池的详细日志，确认是否持续等待：

# 数据存储配置中
maxActive=20
maxIdle=10
minIdle=2
maxWait=-1        # 改为 10000（毫秒），快速失败而不是无限等待
testOnBorrow=true
validationQuery=SELECT 1

解决方案

按并发量调整池上限，并设置合理的等待时间。注意所有工作区的池总和 不能超过数据库的 max_connections：

# postgresql.conf
max_connections = 200
shared_buffers = 4GB

# 三个数据存储，每个池 20，合计 60，留出余量给管理连接
# GeoServer 数据存储 -> 连接池参数
maxActive=20
maxIdle=10
minIdle=4
maxWait=10000

排查泄漏：在代码里确保 Connection 在 finally 中关闭， 不要把它放进长生命周期的对象里：

Connection conn = null;
try {
  conn = dataSource.getConnection();
  PreparedStatement ps = conn.prepareStatement(sql);
  ResultSet rs = ps.executeQuery();
  // 处理结果
} finally {
  if (conn != null) conn.close();
}

慢查询加索引，避免一次请求占用连接几十秒：

CREATE INDEX CONCURRENTLY idx_roads_geom
  ON roads USING gist (geom);
ANALYZE roads;

验证

压测 50 并发持续 5 分钟，pg_stat_activity 的连接数稳定在 60 以内， 不再出现 Timeout waiting for connection from pool。 WMS 响应时间回到 300 ms 以内，503 消失。