// PostgreSQL-Fehlerreferenz

PostgreSQL 08006: Verbindungsfehler

Die Verbindung zum Server brach während der Nutzung. Der Serverprozess endete, wurde neu gestartet oder gewaltsam beendet, oder das Netzwerk hat eine unbenutzte Verbindung getrennt.

SQLSTATE
08006
Name
connection_failure
Kategorie
Verbindungsfehler
Fehlermeldung
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

Was es bedeutet

08006 ist ein clientseitiger Code: Treiber melden ihn, wenn eine bestehende Verbindung mitten im Austausch fehlschlägt. Der Server kann über eine nicht mehr funktionierende Verbindung keinen Fehler senden, daher kommt die Meldung von der Client-Bibliothek. Auf libpq basierende Tools (psql, psycopg) geben die obige Meldung aus, und PgJDBC meldet SQLSTATE 08006 mit An I/O error occurred while sending to the backend.

Das Serverlog erklärt es normalerweise: ein Backend-Absturz und Neustart, ein Out-of-Memory-Kill, ein Administrator, der die Sitzung beendet, oder gar nichts, wenn eine Firewall oder ein Load-Balancer eine untätige TCP-Verbindung stillschweigend getrennt hat.

Häufige Ursachen

  • Der Serverprozess für die Sitzung ist abgestürzt oder wurde beendet, oft durch den Out-of-Memory-Killer des Betriebssystems, der PostgreSQL dazu bringt, alle Sitzungen neu zu starten.
  • Der Server wurde neu gestartet oder es lief ein Failover.
  • Eine Firewall, ein NAT-Gateway oder ein Cloud-Load-Balancer hat eine Verbindung abgebrochen, die länger als ihr Timeout inaktiv war.
  • Die Sitzung wurde beendet durch pg_terminate_backend() oder ein Inaktivitäts-Timeout, und der Client bemerkte dies erst bei seiner nächsten Abfrage.

Wie du es behebst

  1. Prüfe das Serverprotokoll rund um den Zeitpunkt des Fehlers auf terminated by signal, server process ... was terminatedoder einen Neustart.

  2. Wenn eine leerlaufende Verbindung vom Netzwerk getrennt wurde, aktiviere TCP-Keepalives auf dem Server (oder dem Client), damit die Verbindung nie als leerlaufend aussieht.

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. Konfiguriere den Verbindungspool so, dass Verbindungen geprüft oder recycelt werden, bevor sie vergeben werden, und wiederhole den Vorgang einmal auf einer frischen Verbindung, wenn es sicher ist.

  4. Wenn dem Server der Speicher ausgegangen ist, finde die Abfrage, die ihn verbraucht hat, und senk work_mem oder die Anzahl der gleichzeitigen Verbindungen.

Zugehörige Fehler

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.