// PostgreSQL-Fehlerreferenz

PostgreSQL 08001: Verbindung konnte nicht hergestellt werden

Der Client konnte überhaupt keine Verbindung zum Server herstellen: an diesem Host und Port lauscht nichts, eine Firewall, DNS oder ein Timeout.

SQLSTATE
08001
Name
sqlclient_unable_to_establish_sqlconnection
Kategorie
Verbindungsfehler
Fehlermeldung
connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused
	Is the server running on that host and accepting TCP/IP connections?

Was es bedeutet

08001 ist ein clientseitiger SQLSTATE: Treiber wie PgJDBC und Npgsql melden ihn, wenn sie keine Verbindung herstellen können, und auf libpq basierende Tools geben Meldungen wie die obige aus. Der Server hat nie einen Anmeldeversuch gesehen, das Problem liegt also am Netzwerkpfad oder daran, dass der Server nicht lauscht, nicht an den Anmeldedaten.

Der Betriebssystemfehler am Ende sagt, welcher: Connection refused bedeutet, dass der Host geantwortet hat, aber nichts an diesem Port lauscht; timeout expired oder Operation timed out bedeutet normalerweise, dass eine Firewall die Pakete verworfen hat; could not translate host name ist DNS.

Häufige Ursachen

  • Der PostgreSQL-Server läuft nicht oder lauscht auf einem anderen Port.
  • listen_addresses ist localhost (Standard), sodass der Server nur lokale Verbindungen akzeptiert.
  • Eine Firewall, Sicherheitsgruppe oder Docker-Portweiterleitung blockiert Port 5432.
  • Falscher Hostname oder ein Hostname, der vom Client aus nicht aufgelöst wird.
  • Verbindung zu localhost von innerhalb eines Containers, der sich auf den Container selbst bezieht.

Wie du es behebst

  1. Prüfe auf dem Server, ob PostgreSQL läuft und auf welchen Adressen und welchem Port es lauscht.

    SHOW listen_addresses;
    SHOW port;
  2. Netzwerkverbindungen erlauben: setze listen_addresses = '*' (oder die Adresse des Servers) in postgresql.conf und neu starten, dann eine pg_hba.conf Regel für die Clients hinzufügen.

  3. Teste den Netzwerkpfad vom Client, zum Beispiel pg_isready -h db.example.com -p 5432, und öffne den Port in der Firewall oder Sicherheitsgruppe.

  4. Verbinde dich aus einem Container heraus über den Dienstnamen des Datenbankcontainers oder die Host-Adresse statt mit localhost.

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.