// Référence des erreurs PostgreSQL

PostgreSQL 28P01 : l'authentification par mot de passe a échoué

PostgreSQL a rejeté le mot de passe de cet utilisateur. Mot de passe incorrect, rôle sans mot de passe, ou mot de passe haché dans un format que le serveur n'accepte plus.

SQLSTATE
28P01
Nom
invalid_password
Catégorie
Spécification d'autorisation invalide
Message d'erreur
password authentication failed for user "app"

Ce que cela signifie

Le serveur a trouvé un pg_hba.conf règle qui demande un mot de passe (scram-sha-256, md5 ou password) pour cette connexion, et le mot de passe que le client a envoyé ne correspondait pas au mot de passe stocké du rôle.

Par sécurité, le client apprend seulement que le mot de passe est refusé. Le journal du serveur contient la raison, par exemple User "app" has no password assigned ou Role "app" does not exist.

Causes courantes

  • Mot de passe incorrect, ou un mot de passe avec des caractères spéciaux déformés dans une URL de connexion (ils doivent être encodés en pourcentage).
  • Le rôle n'existe pas ou n'a pas de mot de passe défini ; le client voit toujours password authentication failed.
  • Le mot de passe du rôle est stocké sous la forme d'un hachage MD5 mais pg_hba.conf exige scram-sha-256, après une mise à jour qui fait de SCRAM la valeur par défaut.
  • Le client a récupéré un mot de passe différent depuis PGPASSWORD ou un .pgpass fichier.

Comment le corriger

  1. Lisez l'entrée du journal du serveur pour la connexion échouée ; elle indique la vraie raison.

  2. Définissez un nouveau mot de passe en tant que superutilisateur (dans psql, \password app les invites sans l'écho).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. Vérifiez comment le mot de passe est stocké. Une valeur commençant par md5 doit être réinitialisée après le changement password_encryption en scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. Vérifiez quelle ligne de pg_hba.conf ligne correspondait ; la vue affiche le fichier tel que le serveur l'a chargé.

    SELECT line_number, type, database, user_name, address, auth_method
    FROM pg_hba_file_rules;
  5. Encodez les caractères spéciaux dans les URL de connexion, par exemple @ comme %40: postgresql://app:p%40ss@db:5432/shop.

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.