// PostgreSQL-Fehlerreferenz

PostgreSQL 28P01: Passwortauthentifizierung fehlgeschlagen

PostgreSQL hat das Passwort für diesen Benutzer abgelehnt. Ein falsches Passwort, eine Rolle ohne Passwort oder ein Passwort, das in einem Format gehasht wurde, das der Server nicht mehr akzeptiert.

SQLSTATE
28P01
Name
invalid_password
Kategorie
Ungültige Berechtigungsspezifikation
Fehlermeldung
password authentication failed for user "app"

Was es bedeutet

Der Server hat einen pg_hba.conf Regel, die ein Passwort verlangt (scram-sha-256, md5 oder password) für diese Verbindung, und das vom Client gesendete Passwort stimmte nicht mit dem gespeicherten Passwort der Rolle überein.

Aus Sicherheitsgründen erfährt der Client nur, dass das Passwort falsch war. Der Grund steht im Serverprotokoll, zum Beispiel User "app" has no password assigned oder Role "app" does not exist.

Häufige Ursachen

  • Falsches Passwort oder ein Passwort mit Sonderzeichen, das in einer Verbindungs-URL verfälscht wurde (diese müssen prozentkodiert sein).
  • Die Rolle existiert nicht oder hat kein Passwort gesetzt; der Client sieht dennoch password authentication failed.
  • Das Passwort der Rolle wird als MD5-Hash gespeichert, aber pg_hba.conf erfordert scram-sha-256, nach einem Upgrade, das SCRAM zum Standard macht.
  • Der Client hat ein anderes Passwort ausgelesen von PGPASSWORD oder einem .pgpass Datei aufbewahrt.

Wie du es behebst

  1. Lies den Server-Protokolleintrag für das fehlgeschlagene Login; er nennt den eigentlichen Grund.

  2. Setze ein neues Passwort als Superuser (in psql, \password app wird ohne Echo-Eingabe abgefragt).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. Prüfe, wie das Passwort gespeichert wird. Ein Wert, der mit md5 beginnt, muss nach dem Wechsel zurückgesetzt werden password_encryption zu scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. Prüfe, welche pg_hba.conf Zeile übereinstimmte; die Ansicht zeigt die Datei so, wie sie der Server geladen hat.

    SELECT line_number, type, database, user_name, address, auth_method
    FROM pg_hba_file_rules;
  5. Sonderzeichen in Verbindungs-URLs prozentkodieren, zum Beispiel @ als %40: postgresql://app:p%40ss@db:5432/shop.

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.