知识条目 / PostgreSQL

PostgreSQL 报 sorry, too many clients already 如何恢复?

区分连接池配置过大、空闲连接不释放与长事务占用,先释放异常会话,再调整 max_connections 与连接池。

该报错表示后端进程数达到 max_connections。PostgreSQL 每连接一个进程,调大上限会显著增加内存与上下文切换,应先处理连接来源与泄漏。

处理步骤

  1. 统计连接状态按 state、application_name、usename 聚合 pg_stat_activity,识别 idle、idle in transaction 与 active 的占比。
  2. 定位异常来源查看长时间空闲连接与来源主机,核对应用连接池上限、连接复用和超时设置。
  3. 释放与限流终止确认无用的空闲会话,为业务账号设置连接上限(ALTER ROLE ... CONNECTION LIMIT),并让应用经 PgBouncer 收敛连接。
  4. 评估上限按可用内存与每连接开销估算 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

官方文档

同库知识