PostgreSQL / 系统课时

识别连接上限触发

识别连接上限触发

看到应用报“拿不到连接”并不等于 PostgreSQL 已经耗尽连接。真正触发数据库侧上限时,服务器会拒绝新的连接;而客户端连接池容量不足时,数据库可能仍有可用连接。排查的关键是同时核对服务器上限、当前客户端会话、保留连接槽位以及客户端池状态。

学习目标

  • 能确认 PostgreSQL 当前连接上限、保留槽位和客户端会话数
  • 能识别服务器达到连接上限时的典型拒绝现象
  • 能区分数据库端耗尽与客户端连接池自身容量不足

先确认服务器侧容量

先查看 max_connections 和 superuser_reserved_connections,再统计客户端会话。这里按 backend_type = 'client backend' 过滤,避免把数据库内部后台进程混入客户端连接判断。

sql
SHOW max_connections;
SHOW superuser_reserved_connections;

SELECT count(*) AS client_sessions
FROM pg_stat_activity
WHERE backend_type = 'client backend';

预期结果:

text
 max_connections
-----------------
 100
(1 row)

 superuser_reserved_connections
--------------------------------
 3
(1 row)

 client_sessions
----------------
 96
(1 row)

96 个客户端会话说明连接已经很紧张,但不能把 100 - 96 = 4 直接称为业务可用剩余槽位。普通连接受到 superuser_reserved_connections 保留槽位影响,而且当前客户端会话中还可能包含超级用户连接,因此还要结合连接角色判断普通连接是否真的接近上限。

观察连接是否被某个来源吃满

将会话按用户和应用聚合,可以判断连接是否集中来自单个服务。连接总数很高但只有一个应用异常增长,通常比“所有应用都均匀增加”更容易定位。

sql
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;

预期结果:

text
 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。具体文本会随触发条件和服务端版本而变化,因此排查时应以实际错误日志为准。

bash
psql "host=<HOST> port=<PORT> dbname=<DBNAME> user=<USER>"

预期结果:

text
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 耗尽的证据。现场应结合实际报错、当前会话数和连接角色一起判断。

区分服务器耗尽和客户端池不足

这两个问题的表象很像,但证据不同。可以按下面的顺序判断:

  1. 查看数据库当前客户端会话数,并结合 max_connections 与 superuser_reserved_connections 判断普通连接区间是否接近耗尽。
  2. 查看是否存在大量 idle、active 或 idle in transaction 会话。
  3. 查看应用日志中的具体连接异常,确认请求是在 PostgreSQL 建连阶段失败,还是已经连上数据库后在连接池中排队。
  4. 回到客户端连接池指标,确认池的最大连接数、当前使用数和等待连接数。

典型判断可以概括为:

现象 更可能的原因
PostgreSQL 会话数逼近连接阈值,新连接直接被服务器拒绝 数据库侧连接耗尽
PostgreSQL 仍有可用连接,但应用持续等待获取连接 客户端连接池容量不足或池内连接不可用
数据库连接数不高,却有大量 idle in transaction 事务边界异常,未必是池容量问题
单个应用实例连接数异常高,其他实例正常 单实例池配置、连接泄漏或流量倾斜

用普通连接阈值做一次现场判断

在事故现场,可以把实例级连接阈值和非超级用户客户端会话数放在一起看。普通角色理论上最多使用 max_connections - superuser_reserved_connections 个连接,因此比单纯计算总客户端会话差值更准确;这仍只是现场快照,不代表某个具体角色一定还能成功建立连接。

sql
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;

预期结果:

text
 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 等限制。如果数据库仍有充足普通连接空间,却出现应用“获取连接失败”,就应把排查重点转向客户端连接池。

连接耗尽治理的第一原则是先分清谁没有连接可用:服务器没有可用连接槽位,还是客户端池没有可借出的连接。两者的修复方向完全不同。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

识别连接上限触发

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通