// PostgreSQL 错误参考

PostgreSQL 53300:连接过多

服务器已达到 max_connections 并拒绝新的会话。通常是连接泄露或连接池总共打开的连接数超过允许值。

SQLSTATE
53300
名称
too_many_connections
类别
资源不足
错误信息
sorry, too many clients already

它的意思

PostgreSQL 每个连接运行一个服务器进程,并将总数限制为 max_connections (默认 100)。当所有槽位都被占满时,新连接还没来得及登录就会以 53300 失败。

会预留少量槽位给超级用户(superuser_reserved_connections,默认为 3),而在 PostgreSQL 16 及更高版本上,还适用于 pg_use_reserved_connections。普通角色随后会看到 remaining connection slots are reserved for roles with the SUPERUSER attribute (不同版本措辞不同)但代码相同。角色或数据库也可以有自己的 CONNECTION LIMIT,会失败并报 too many connections for role "app".

常见原因

  • 应用程序泄漏连接:打开之后从不关闭,也从不归还给连接池。
  • 多个应用实例,每个都有自己的连接池,总数超过 max_connections.
  • 许多会话处于 idle in transaction,占着连接槽位和锁。
  • 流量突增,或某个作业为每个任务都打开一个连接。

如何修复它

  1. 查看谁已连接、在做什么(以超级用户身份连接,超级用户仍能连入)。

    SELECT usename, application_name, client_addr, state, count(*)
    FROM pg_stat_activity
    GROUP BY 1, 2, 3, 4
    ORDER BY count(*) DESC;
  2. 结束卡在事务中空闲的会话,或结束属于失控客户端的会话。

    SELECT pg_terminate_backend(pid)
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
      AND state_change < now() - interval '10 minutes';
  3. 修复泄漏,或缩小各个连接池使其总数保持在限制内,并在大量小客户端前面放一个 PgBouncer 这样的连接池。

  4. 让服务器端自动结束被遗弃的会话。

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. 提高 max_connections 仅当服务器内存足够时才可用;并且需要重启。

    ALTER SYSTEM SET max_connections = 200;  -- takes effect after restart

问题

PostgreSQL 能处理多少个连接?

默认的 max_connections 是 100。每个连接都是一个拥有独立内存的独立进程,因此面对数百个大多空闲的连接,用连接池比把 max_connections 调得很高更合适。

相关错误

更多资源不足错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。