PostgreSQL提示连接数已满怎么办
程序报too many clients already或提示剩余连接槽位仅供特定角色使用时,说明新的数据库连接被配额限制。先保留准确报错:too many connections for role与for database还可能分别指向角色和数据库限制,不一定是整个实例都满了。
以下以PostgreSQL 16为例,由已有数据库管理员或获准的监控账号排查。不要把业务账号临时改成超级用户,也不要为腾出连接立即重启数据库。已存在的管理会话先保留,避免把最后的排障入口主动关掉。
先看实际限制,不急着调大数字
使用现有有效的连接方式进入正确实例,下面SQL在psql中执行;远程管理沿用已有SSH隧道方案,不另开公网端口:
SELECT version(), current_database(), inet_server_addr(), inet_server_port();
SELECT name, setting, unit, pending_restart
FROM pg_settings
WHERE name IN ('max_connections', 'reserved_connections',
'superuser_reserved_connections')
ORDER BY name;
SELECT rolname, rolconnlimit FROM pg_roles WHERE rolname = 'appuser';
SELECT datname, datconnlimit FROM pg_database WHERE datname = 'appdb';
appuser和appdb要换成真实角色与库名。setting是当前参数值,pending_restart为true表示有变更等待重启,不代表新值已经生效。角色、数据库的连接限额为-1表示未设置这项限额,但仍受实例总配额约束。保留槽位用于管理和获准角色,所以普通应用可能在尚未达到max_connections时就无法建立新连接。其他版本不存在的参数不会出现在这份查询结果中。
管理员也无法新建连接时,优先从应用侧暂停已经确认的异常任务、连接重试或多余实例,让它按正常退出流程释放连接;记录故障时间和日志,再尝试管理连接。不是随意关闭所有业务,也不要修改认证规则来绕过配额。
是哪组连接占住了位置
先汇总客户端连接,避免把autovacuum等后台进程混进业务连接数。没有权限看到完整信息时由管理员代查:
SELECT datname, usename, application_name, client_addr, state,
count(*) AS connections
FROM pg_stat_activity
WHERE backend_type = 'client backend'
GROUP BY datname, usename, application_name, client_addr, state
ORDER BY connections DESC;
结果按占用较多的来源排在前面。对照应用部署数量、连接池配置和最近发布记录;application_name是客户端提供的标识,不能单独当作身份凭据。查询是当时的快照,故障恢复后看到数量下降,不代表刚才没有打满。
| 连接状态 | 怎样理解 |
|---|---|
| idle | 正在等待下一条命令,可能是正常连接池,也可能是没有释放的连接;不能一律结束。 |
| idle in transaction | 事务仍打开但暂时没有执行SQL,应检查应用未提交或未回滚的路径。 |
| active | 正在执行查询,但可能等待锁或其他事件;不能直接认定CPU不够。 |
继续查看目标库中的具体连接,不输出SQL正文,以免暴露业务参数:
SELECT pid, usename, application_name, client_addr, state,
clock_timestamp() - state_change AS state_age,
clock_timestamp() - xact_start AS transaction_age,
wait_event_type, wait_event
FROM pg_stat_activity
WHERE backend_type = 'client backend'
AND datname = 'appdb'
AND pid <> pg_backend_pid()
ORDER BY xact_start NULLS LAST, state_change
LIMIT 20;
长时间处于同一状态值得检查,但时长本身不是终止依据。应把PID、账号、来源和应用任务对应起来,确认它是在正常等待、处理中断后的事务,还是被持续重建的连接。
先控制来源,再释放确认可结束的会话
连接数不断上涨时,先限制异常应用的并发和重试,并修复连接归还逻辑。连接池容量要按实际进程数计算:例如3个实例、每个4个工作进程、每进程池上限20,潜在上限就是240,并不是20。还要给其他应用、维护与监控留出余量,不能把全部名额分给一个网站。
优先让应用正常关闭不再需要的连接。确有遗留会话必须由数据库侧终止时,先确认其任务可中断、未提交事务可回滚,并处理自动重连来源。由有权限的管理员立即复核PID和来源后,才执行下面的单会话示例:
SELECT pg_terminate_backend(pid, 5000)
FROM pg_stat_activity
WHERE pid = 12345
AND usename = 'appuser'
AND datname = 'appdb'
AND backend_type = 'client backend'
AND pid <> pg_backend_pid();
替换所有示例值。此操作会断开会话,未提交事务会回滚;订单等业务是否已提交还须由应用核查。没有返回行说明目标条件不匹配,不应扩大条件批量尝试。这里等待最多5秒确认退出,仍须重新查询连接状态。只取消一条查询并不等于释放它的连接。
恢复之后看连接是否再次堆积
用原业务账号新建一次连接,运行只读检查,再验证真实页面或健康接口;已有会话还能查询不能证明新连接已经恢复。连续观察相近负载下的连接数、等待时间、应用错误及池中空闲连接,避免释放几个连接后几秒内再次打满。
只有排除了连接泄漏、池配置过大和不必要的并发,才评估提高max_connections。它需要重启才能应用,会增加潜在资源压力;不能靠一次reload即时扩容。有主备部署时还要一起核对备库要求,并安排配置备份、维护窗口与回退。
需要补查实例和业务账号的基本连接信息,可参考PostgreSQL实例与业务数据库检查。本次处理的目标是恢复合理的新连接能力,并让连接数量回到可持续的范围。