PostgreSQL 53300:連線過多
伺服器已達 max_connections 上限,拒絕新的工作階段。通常是連線洩漏,或數個連線集區合計開啟的連線數超過上限。
- SQLSTATE
53300- 名稱
too_many_connections- 類別
- 資源不足
它的意義
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,佔用槽位和鎖。 - 流量尖峰,或是每個工作各開一條連線的作業。
如何修正
-
查看誰已連線以及他們在做什麼(以超級使用者身分連線,超級使用者仍然進得去)。
SELECT usename, application_name, client_addr, state, count(*) FROM pg_stat_activity GROUP BY 1, 2, 3, 4 ORDER BY count(*) DESC;
-
結束在交易中閒置卡住的工作階段,或屬於失控用戶端的工作階段。
SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle in transaction' AND state_change < now() - interval '10 minutes';
-
修正洩漏問題,或縮減各連線池讓總數低於上限,並在眾多小型用戶端前面放上 PgBouncer 這類的連線池工具。
-
讓伺服器自動結束被遺棄的工作階段。
ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min'; SELECT pg_reload_conf();
-
調高
max_connections只有在伺服器有足夠記憶體的情況下;它需要重新啟動。ALTER SYSTEM SET max_connections = 200; -- takes effect after restart
問題
PostgreSQL 可以處理多少連線?
預設的 max_connections 為 100。每個連線都是一個擁有自己記憶體的獨立處理程序,所以數百條大部分時間都在閒置的連線,交給連線池處理會比調高 max_connections 更合適。
相關錯誤
57P03目前無法連線25P03交易中閒置工作階段的逾時28000授權規格無效1040MySQL:連線過多ORA-00018Oracle:超過最大工作階段數ORA-00020Oracle:超過最大處理序數
更多資源不足錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。