发布时间:2026-10-01 04:31 更新时间:2026-10-01 04:31 阅读量:12
线上 PostgreSQL 报出 FATAL: sorry, too many clients already,第一反应是去数连接:select count(*) from pg_stat_activity; 一看才一百多条,而 max_connections 明明配了 500,中间还挂着一个 pgbouncer。这时候最容易陷入的误区,就是拿应用侧看到的“连接数”去和数据库侧的“连接上限”直接对比。实际上这两个数字口径完全不同,中间隔着一层连接池,还隔着 PostgreSQL 自己保留的几个名额。
本文把这几层口径拆开讲清楚:谁在数连接、数的是哪一段、为什么看起来没满却报错,以及怎么用几条命令把差异定位出来。读完你至少能判断问题出在 pgbouncer 的客户端槽位、服务端池子,还是 PostgreSQL 的 max_connections 与保留连接上。
一个典型的链路是:应用 → pgbouncer → PostgreSQL。这条链路上有三个互相独立的“连接数”。
第一层是应用与 pgbouncer 之间的客户端连接,数量由 pgbouncer 配置里的 max_client_conn 控制。第二层是pgbouncer 与 PostgreSQL 之间的服务端连接,由 default_pool_size(以及按库/用户覆盖的 pool_size)控制,多个客户端可以复用同一个服务端连接,这也是连接池存在的意义。第三层才是PostgreSQL 自己能接受的连接总数,由 max_connections 决定。
当应用报 too many clients,要分清是 pgbouncer 拒绝了新客户端(日志里通常是 no more connections allowed (max_client_conn) 之类),还是 pgbouncer 把错误原样透传自 PostgreSQL。前者调 max_client_conn,后者要看数据库侧的真实占用。
先看 pgbouncer 的实时状态。连上 pgbouncer 的管理库(默认 pgbouncer),执行:
psql -p 6432 -U pgbouncer pgbouncer -c "SHOW POOLS;"
psql -p 6432 -U pgbouncer pgbouncer -c "SHOW CLIENTS;"
psql -p 6432 -U pgbouncer pgbouncer -c "SHOW SERVERS;"
SHOW POOLS 输出里的 cl_active、cl_waiting、sv_active、sv_idle 是关键列:cl_waiting 长期大于 0,说明客户端在排队等服务端连接,池子偏小;sv_active 逼近 pool_size,说明服务端连接已经用满。SHOW SERVERS 则能直接看到 pgbouncer 到 PostgreSQL 实际开了多少条连接。
PostgreSQL 的 max_connections 并不是全部给普通用户的。还有一个参数 superuser_reserved_connections,默认是 3,它从 max_connections 里划走一部分,只留给超级用户使用。普通用户能用的连接上限实际上是 max_connections - superuser_reserved_connections。
也就是说,如果 max_connections = 100、superuser_reserved_connections = 3,普通应用最多只能占 97 条,第 98 条普通连接就会报 too many clients。查一下当前值:
psql -c "SHOW max_connections;"
psql -c "SHOW superuser_reserved_connections;"
psql -c "SELECT count(*) FROM pg_stat_activity;"
psql -c "SELECT usename, state, count(*) FROM pg_stat_activity GROUP BY 1,2 ORDER BY 3 DESC;"
这里还要注意 pg_stat_activity 的口径。它统计的是当前后端进程,包含了后台辅助进程(比如 autovacuum worker、walsender 等,视版本和状态而定),也包含 state = 'idle' 的空闲连接——空闲连接同样占名额。很多“没满”的错觉,就是只看了 active 状态的连接,忽略了 idle 的。
另外,连接到达 PostgreSQL 之前还要经过操作系统的限制:ulimit -n 打开文件数、net.core.somaxconn 等。如果这些先到瓶颈,报错形态可能不同,但排查时一并确认没坏处。具体参数含义以官方文档和实际环境为准。
pgbouncer 有三种常见池模式:session、transaction、statement。很多人用 transaction 模式,希望一个事务结束就把服务端连接还回池子。但要注意,transaction 模式下服务端连接是按事务复用,不是按语句,长事务、持有游标、SET 会话变量等操作都会让连接长时间被占住,池子很快见底。
更隐蔽的是,如果应用在事务里做了耗时操作(比如等外部接口),这条服务端连接就一直不释放。此时 SHOW POOLS 里 sv_active 居高不下,而 PostgreSQL 侧的 pg_stat_activity 可能只看到少量 active 连接——因为 pgbouncer 复用了连接,数据库里看不到那么多后端。这就是“应用觉得连接多、数据库觉得连接少”的根源。
排查时可以两边对照看:pgbouncer 侧 SHOW SERVERS 的数量,应当大致等于 PostgreSQL 侧来自 pgbouncer 的连接数。如果对不上,检查是否有其他直连路径绕过了 pgbouncer。可以用下面这条查询确认连接来源:
psql -c "SELECT client_addr, usename, state, count(*) FROM pg_stat_activity GROUP BY 1,2,3 ORDER BY 4 DESC;"
如果发现大量连接来自应用服务器网段而非 pgbouncer 所在主机,说明有服务没走池子,直连把 max_connections 吃掉了,这时再怎么调 pool_size 也没用,得先把直连收敛到 pgbouncer。
调整方向也按层来:客户端排队多就适当提高 max_client_conn,但要留意 pgbouncer 自身的内存和文件句柄;服务端连接吃紧就评估 default_pool_size;数据库侧确实不够,再考虑调 max_connections,同时评估 shared_buffers 等内存参数是否跟得上,因为每增加一条连接都会带来额外内存开销。改完记得 reload 或重启对应服务,pgbouncer 支持 RELOAD; 平滑生效。
遇到 too many clients,先别急着加 max_connections,按“客户端 → 池子 → 数据库”三层把口径对齐:用 SHOW POOLS 看 pgbouncer 的排队与占用,用 pg_stat_activity 按用户和来源地址分组看真实连接分布,再扣掉 superuser_reserved_connections 的保留名额。多数情况下,问题要么是 idle 连接没回收,要么是长事务占住了池子里的服务端连接,要么是有服务绕过池子直连。定位清楚再动手调参数,比盲目扩大上限更稳妥。
| 📑 | 📅 |
|---|---|
| 容器OOM Kill但宿主内存充足:cgroup统计口径与memory.max排查 | 2026-10-01 |
| Nginx日志499与502混合:按时间窗口对齐后端日志定位 | 2026-10-01 |
| Linux磁盘满了但df与du不一致:挂载点遮蔽排查 | 2026-09-30 |
| Redis连接数暴涨却无慢命令:连接泄漏定位实战 | 2026-09-30 |
| MySQL 8 慢查询日志查不到 SQL:digest 归并与真实语句还原 | 2026-09-30 |
| Linux RAID 降级与重建排查:mdadm 实战 | 2026-10-01 |
| Docker容器时区正确日志时间戳却偏移:三层对齐排查 | 2026-10-01 |
| 企业建站服务器配置怎么选:按访问量与程序类型估算 | 2026-10-02 |
| 1核2G能撑多少访问量:WordPress与自研程序的瓶颈顺序 | 2026-10-02 |
| 企业官网选云服务器还是虚拟主机:并发、扩展、维护成本对照 | 2026-10-02 |