// 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。