// PostgreSQL-Fehlerreferenz

PostgreSQL 53300: zu viele Verbindungen

Der Server hat max_connections erreicht und lehnt neue Sitzungen ab. Normalerweise ist es ein Verbindungsleck oder es sind Pools, die zusammen mehr Verbindungen öffnen, als erlaubt.

SQLSTATE
53300
Name
too_many_connections
Kategorie
Unzureichende Ressourcen
Fehlermeldung
sorry, too many clients already

Was es bedeutet

PostgreSQL führt einen Serverprozess pro Verbindung aus und begrenzt die Gesamtzahl mit max_connections (standardmäßig 100). Wenn jeder Platz belegt ist, schlägt eine neue Verbindung mit 53300 fehl, bevor sie sich anmelden kann.

Einige Plätze werden für Superuser zurückgehalten (superuser_reserved_connections, standardmäßig 3) und ab PostgreSQL 16 für Rollen in pg_use_reserved_connections. Gewöhnliche Rollen sehen dann remaining connection slots are reserved for roles with the SUPERUSER attribute (die Formulierung variiert je nach Version) mit demselben Code. Eine Rolle oder Datenbank kann auch ihre eigene CONNECTION LIMIT, die mit too many connections for role "app".

Häufige Ursachen

  • Eine Anwendung leakt Verbindungen: Sie öffnet sie und schließt sie nie oder gibt sie nie an den Pool zurück.
  • Mehrere App-Instanzen, jede mit eigenem Pool, summieren sich auf mehr als max_connections.
  • Viele Sitzungen im Leerlauf idle in transaction, und belegt dabei Slots und Sperren.
  • Eine Lastspitze oder ein Job, der für jede Aufgabe eine Verbindung öffnet.

Wie du es behebst

  1. Sehen, wer verbunden ist und was die Sitzungen tun (als Superuser verbinden, der noch reinkommt).

    SELECT usename, application_name, client_addr, state, count(*)
    FROM pg_stat_activity
    GROUP BY 1, 2, 3, 4
    ORDER BY count(*) DESC;
  2. Beende Sitzungen, die untätig in einer Transaktion festhängen oder zu einem außer Kontrolle geratenen Client gehören.

    SELECT pg_terminate_backend(pid)
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
      AND state_change < now() - interval '10 minutes';
  3. Behebe das Leck oder verkleinere die Pools, damit ihre Summe unter dem Limit bleibt, und stelle einen Pooler wie PgBouncer vor viele kleine Clients.

  4. Lass den Server verwaiste Sitzungen automatisch beenden.

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. Erhöhen max_connections Nur wenn der Server dafür genügend Speicher hat; ein Neustart ist erforderlich.

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

Fragen

Wie viele Verbindungen verkraftet PostgreSQL?

Der Standardwert für max_connections beträgt 100. Jede Verbindung ist ein separater Prozess mit eigenem Speicher, daher werden Hunderte von überwiegend inaktiven Verbindungen besser durch einen Connection Pooler als durch sehr hohe max_connections bedient.

Zugehörige Fehler

Weitere Fehler aufgrund unzureichender Ressourcen

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.