// PostgreSQL エラーリファレンス

PostgreSQL 53300: 接続数が多すぎます

サーバーは max_connections に達しており、新しいセッションを拒否しています。通常は、接続リークか、プール全体で許可数より多くの接続を開いていることが原因です。

SQLSTATE
53300
名前
too_many_connections
カテゴリ
リソース不足
エラーメッセージ
sorry, too many clients already

意味

PostgreSQL は接続ごとに 1 つのサーバープロセスを実行し、その合計は 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 つの接続を開くジョブ。

修正方法

  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 をはじめ、お使いの他のデータベースにも対応します。