知识条目 / PostgreSQL
PostgreSQL 报 sorry, too many clients already 如何恢复?
区分连接池配置过大、空闲连接不释放与长事务占用,先释放异常会话,再调整 max_connections 与连接池。
该报错表示后端进程数达到 max_connections。PostgreSQL 每连接一个进程,调大上限会显著增加内存与上下文切换,应先处理连接来源与泄漏。
处理步骤
- 统计连接状态按 state、application_name、usename 聚合 pg_stat_activity,识别 idle、idle in transaction 与 active 的占比。
- 定位异常来源查看长时间空闲连接与来源主机,核对应用连接池上限、连接复用和超时设置。
- 释放与限流终止确认无用的空闲会话,为业务账号设置连接上限(ALTER ROLE ... CONNECTION LIMIT),并让应用经 PgBouncer 收敛连接。
- 评估上限按可用内存与每连接开销估算 max_connections,同步调整 shared_buffers 等参数并重启验证。
示例
SHOW max_connections;
SELECT state, count(*)
FROM pg_stat_activity
GROUP BY state
ORDER BY count(*) DESC;
SELECT pid, usename, application_name, client_addr,
now() - state_change AS idle_for, state
FROM pg_stat_activity
WHERE state <> 'active'
ORDER BY idle_for DESC
LIMIT 20;
pg_terminate_backend 会中断会话,需先确认不是关键任务;连接数告警应同时监控 idle in transaction。
关键词
postgresql · too many clients · 连接数 · max_connections · pg_stat_activity · 连接池 · pgaudit
官方文档
同库知识
- PostgreSQL 的 VACUUM 有什么作用?理解死元组清理、可见性映射与事务冻结,区分普通 VACUUM 和 VACUUM FULL 的代价。
- PostgreSQL 锁等待与阻塞如何定位?用 pg_blocking_pids 还原阻塞链,结合事务时长与语句决定安全的处理方式。
- PostgreSQL 出现 idle in transaction 与锁阻塞怎么办?idle in transaction 会长期持有快照与锁并阻止 vacuum,先定位事务为何不结束,再终止异常会话并设置空闲事务超时。
- PostgreSQL WAL 目录暴涨导致磁盘满如何处理?先区分归档失败、复制槽滞留与检查点过慢三类原因,再恢复归档或清理失效复制槽,避免直接删除 pg_wal 文件。
- PostgreSQL 复制槽导致 WAL 无法释放怎么办?确认复制槽是否仍被订阅或备库使用,评估丢失该槽的影响后再删除;活跃槽应修复消费端而不是直接清理。