So sieht die Meldung aus
psql: error: connection to server at "127.0.0.1", port 5432 failed: FATAL: password authentication failed for user "appuser"
2026-10-12 09:14:03 CEST [4121] FATAL: password authentication failed for user "appuser"
2026-10-12 09:14:03 CEST [4121] DETAIL: Connection matched pg_hba.conf line 113: "host all all 127.0.0.1/32 scram-sha-256"Häufige Ursachen
- Das Passwort ist falsch, z. B. ein altes in der App-Konfiguration, in einer Umgebungsvariable oder in
~/.pgpass. - Die Rolle hat kein Passwort, oder es wurde anders gesetzt, als es die Zeile erwartet.
- Eine andere
pg_hba.conf-Zeile greift zuerst. Der erste Treffer gewinnt, daher kann ein anderer Benutzer, eine andere Datenbank, Adresse oder Methode gelten. - Sonderzeichen im Passwort zerstören eine Verbindungs-URL, etwa
@,:,/oder%, und müssen prozentkodiert werden. - Der Benutzername ist anders geschrieben als die Rolle in der Datenbank, auch in der Groß-/Kleinschreibung.
Prüfen
- Welche Rollen gibt es und dürfen sich anmelden?
sudo -u postgres psql -c '\du' - Welche Zeile hat die fehlgeschlagene Anmeldung getroffen? DETAIL im Log lesen
sudo tail -n 30 /var/log/postgresql/postgresql-*-main.log - Aktive Regeln der Reihe nach
sudo -u postgres psql -c 'SELECT line_number, type, database, user_name, address, auth_method FROM pg_hba_file_rules' - Verwendete Passwort-Verschlüsselung
sudo -u postgres psql -c 'SHOW password_encryption'
Lösung
- Ein neues Passwort interaktiv setzen, damit es nicht in der Shell-History landet:
sudo -u postgres psql, dann\password appuser. - Dasselbe Passwort in der App-Konfiguration verwenden. Sonderzeichen in einer URL prozentkodieren oder auf getrennte Parameter für Host, Benutzer und Passwort wechseln.
- Reihenfolge und Inhalt der
pg_hba.conf-Zeilen korrigieren und neu laden:sudo systemctl reload postgresql. Nutze nietrustfür Netzwerkadressen als schnelle Lösung. - Unterstützt eine alte Client-Bibliothek nur md5, die Bibliothek aktualisieren, statt die Sicherheit des Servers zu senken. Nach einer Änderung von
password_encryptiondie Passwörter neu setzen. - Einen veralteten Eintrag in
~/.pgpassoder eine VariablePGPASSWORDentfernen, die das Passwort überschreibt, das du zu nutzen glaubst.
Typisches Szenario
Eine Anwendung im Docker-Container verbindet sich mit postgres://app:p@ss/word@db:5432/appdb. Das Passwort p@ss/word enthält ein @ und einen Schrägstrich, die URL wird falsch zerlegt, und PostgreSQL meldet „password authentication failed for user“. Im Serverlog steht zusätzlich die Zeile „Connection matched pg_hba.conf line …“ und der Grund. Lies diese zwei Zeilen zuerst, sie sagen, welche Regel gegriffen hat und warum das Passwort abgelehnt wurde.
Häufige Fragen
Warum klappt psql auf dem Server, aber nicht aus der App?
Lokal nutzt der Socket oft eine andere Regel (peer) als das Netzwerk (scram-sha-256). Teste mit psql -h 127.0.0.1, um denselben Weg wie die App zu nehmen.
Wie unterscheidet sich das von „no pg_hba.conf entry“?
Hier hat eine Zeile gegriffen und das Passwort ist gescheitert. Bei „no pg_hba.conf entry“ hat gar keine Zeile gepasst, der Server lehnt ab, bevor er ein Passwort verlangt.
Wo finde ich den genauen Grund im Log?
In der Logdatei des Servers, meist unter /var/log/postgresql/. Dem FATAL folgt eine DETAIL-Zeile mit dem Grund, zum Beispiel „Password does not match for user“, „Role does not exist“ oder „User has no password assigned“. Der Client bekommt aus Sicherheitsgründen nur die allgemeine Meldung.
Welche Zeichen muss ich in einer URL kodieren?
Sonderzeichen werden prozentkodiert: @ wird zu %40, / zu %2F, : zu %3A und % zu %25. Aus p@ss/word wird so p%40ss%2Fword. Einfacher ist es, Host, Benutzer und Passwort in getrennten Parametern zu übergeben, falls die Bibliothek das erlaubt.
Warum scheitern alte Clients nach einer Passwortänderung an scram-sha-256?
Seit PostgreSQL 14 speichert der Server neue Passwörter standardmäßig als SCRAM-Hash. Sehr alte Client-Bibliotheken, etwa mit libpq vor Version 10, beherrschen SCRAM nicht. Dann hilft ein Update der Bibliothek, oder du speicherst das Passwort bewusst als md5, was aber nicht empfohlen ist.