PostgreSQL / 系统课时
识别连接上限触发
识别连接上限触发
看到应用报“拿不到连接”并不等于 PostgreSQL 已经耗尽连接。真正触发数据库侧上限时,服务器会拒绝新的连接;而客户端连接池容量不足时,数据库可能仍有可用连接。排查的关键是同时核对服务器上限、当前客户端会话、保留连接槽位以及客户端池状态。
学习目标
- 能确认 PostgreSQL 当前连接上限、保留槽位和客户端会话数
- 能识别服务器达到连接上限时的典型拒绝现象
- 能区分数据库端耗尽与客户端连接池自身容量不足
先确认服务器侧容量
先查看 max_connections 和 superuser_reserved_connections,再统计客户端会话。这里按 backend_type = 'client backend' 过滤,避免把数据库内部后台进程混入客户端连接判断。
SHOW max_connections;
SHOW superuser_reserved_connections;
SELECT count(*) AS client_sessions
FROM pg_stat_activity
WHERE backend_type = 'client backend';预期结果:
max_connections
-----------------
100
(1 row)
superuser_reserved_connections
--------------------------------
3
(1 row)
client_sessions
----------------
96
(1 row)96 个客户端会话说明连接已经很紧张,但不能把 100 - 96 = 4 直接称为业务可用剩余槽位。普通连接受到 superuser_reserved_connections 保留槽位影响,而且当前客户端会话中还可能包含超级用户连接,因此还要结合连接角色判断普通连接是否真的接近上限。
观察连接是否被某个来源吃满
将会话按用户和应用聚合,可以判断连接是否集中来自单个服务。连接总数很高但只有一个应用异常增长,通常比“所有应用都均匀增加”更容易定位。
SELECT
usename,
application_name,
count(*) AS sessions
FROM pg_stat_activity
WHERE backend_type = 'client backend'
GROUP BY usename, application_name
ORDER BY sessions DESC;预期结果:
usename | application_name | sessions
---------+------------------+----------
appuser | order-api | 72
appuser | report-api | 14
batch | batch-job | 10
(3 rows)如果 order-api 单独占据绝大多数连接,应继续核对该服务所有实例的连接池上限、实例数以及是否发生连接泄漏。此时不要直接把 max_connections 调大,因为扩大服务器容量可能只是把压力转移到内存、CPU 或锁竞争。
识别数据库拒绝连接
当 PostgreSQL 已没有可供普通角色继续建立连接的空间时,新连接请求会被服务器拒绝。达到实例级 max_connections 上限时,典型报错是 sorry, too many clients already;当进入为超级用户保留的连接区间时,普通角色可能看到 remaining connection slots are reserved for roles with the SUPERUSER attribute。具体文本会随触发条件和服务端版本而变化,因此排查时应以实际错误日志为准。
psql "host=<HOST> port=<PORT> dbname=<DBNAME> user=<USER>"预期结果:
psql: error: connection to server at "<HOST>", port <PORT> failed: FATAL: sorry, too many clients already这里要注意,too many clients already 是实例级连接上限触发的代表性现象;too many connections for role 则更直接对应某个角色的 CONNECTION LIMIT,不能单独作为 max_connections 耗尽的证据。现场应结合实际报错、当前会话数和连接角色一起判断。
区分服务器耗尽和客户端池不足
这两个问题的表象很像,但证据不同。可以按下面的顺序判断:
- 查看数据库当前客户端会话数,并结合
max_connections与superuser_reserved_connections判断普通连接区间是否接近耗尽。 - 查看是否存在大量
idle、active或idle in transaction会话。 - 查看应用日志中的具体连接异常,确认请求是在 PostgreSQL 建连阶段失败,还是已经连上数据库后在连接池中排队。
- 回到客户端连接池指标,确认池的最大连接数、当前使用数和等待连接数。
典型判断可以概括为:
| 现象 | 更可能的原因 |
|---|---|
| PostgreSQL 会话数逼近连接阈值,新连接直接被服务器拒绝 | 数据库侧连接耗尽 |
| PostgreSQL 仍有可用连接,但应用持续等待获取连接 | 客户端连接池容量不足或池内连接不可用 |
数据库连接数不高,却有大量 idle in transaction |
事务边界异常,未必是池容量问题 |
| 单个应用实例连接数异常高,其他实例正常 | 单实例池配置、连接泄漏或流量倾斜 |
用普通连接阈值做一次现场判断
在事故现场,可以把实例级连接阈值和非超级用户客户端会话数放在一起看。普通角色理论上最多使用 max_connections - superuser_reserved_connections 个连接,因此比单纯计算总客户端会话差值更准确;这仍只是现场快照,不代表某个具体角色一定还能成功建立连接。
SELECT
max_conn,
reserved_conn,
client_conn,
non_superuser_client_conn,
GREATEST(max_conn - reserved_conn - non_superuser_client_conn, 0) AS remaining_non_superuser_slots
FROM (
SELECT
current_setting('max_connections')::int AS max_conn,
current_setting('superuser_reserved_connections')::int AS reserved_conn,
(SELECT count(*)
FROM pg_stat_activity
WHERE backend_type = 'client backend') AS client_conn,
(SELECT count(*)
FROM pg_stat_activity AS a
JOIN pg_roles AS r ON r.rolname = a.usename
WHERE a.backend_type = 'client backend'
AND r.rolsuper = false) AS non_superuser_client_conn
) AS s;预期结果:
max_conn | reserved_conn | client_conn | non_superuser_client_conn | remaining_non_superuser_slots
----------+---------------+-------------+---------------------------+-------------------------------
100 | 3 | 96 | 96 | 1
(1 row)这里的 1 表示按实例级保留规则计算,普通连接区间理论上只剩 1 个槽位;它不等于某个应用角色一定还能建立 1 个连接,因为角色还可能受到自己的 CONNECTION LIMIT 等限制。如果数据库仍有充足普通连接空间,却出现应用“获取连接失败”,就应把排查重点转向客户端连接池。
连接耗尽治理的第一原则是先分清谁没有连接可用:服务器没有可用连接槽位,还是客户端池没有可借出的连接。两者的修复方向完全不同。