PostgreSQL 28P01: fallo de autenticación de contraseña
PostgreSQL rechazó la contraseña de este usuario. Puede ser una contraseña incorrecta, un rol sin contraseña o una contraseña cifrada en un formato que el servidor ya no acepta.
- SQLSTATE
28P01- Nombre
invalid_password
Qué significa
El servidor encontró un pg_hba.conf regla que solicita una contraseña (scram-sha-256, md5 o password) para esta conexión, y la contraseña que envió el cliente no coincidía con la que tiene guardada el rol.
Por seguridad, al cliente solo se le dice que la contraseña falló. El registro del servidor guarda el motivo, por ejemplo User "app" has no password assigned o Role "app" does not exist.
Causas comunes
- Contraseña incorrecta, o una contraseña con caracteres especiales dañados en una URL de conexión (deben estar codificados en porcentaje).
- El rol no existe o no tiene contraseña asignada; el cliente aún ve
password authentication failed. - La contraseña del rol está almacenada como un hash MD5, pero
pg_hba.confrequierescram-sha-256, tras una actualización al valor predeterminado SCRAM. - El cliente tomó una contraseña diferente de
PGPASSWORDo una.pgpassarchivo.
Cómo solucionarlo
-
Lee la entrada del registro del servidor correspondiente al inicio de sesión fallido; indica el motivo real.
-
Establece una nueva contraseña como superusuario (en psql,
\password appla pide sin mostrarla).ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
-
Verifica cómo se almacena la contraseña. Un valor que comience con
md5debe restablecerse después de cambiarpassword_encryptionascram-sha-256.SHOW password_encryption; SELECT rolname, left(rolpassword, 14) AS hash_type FROM pg_authid WHERE rolname = 'app';
-
Verifica qué
pg_hba.conflínea coincidió; la vista muestra el archivo tal como lo cargó el servidor.SELECT line_number, type, database, user_name, address, auth_method FROM pg_hba_file_rules;
-
Codifica con porcentaje los caracteres especiales en las URL de conexión, por ejemplo
@como%40:postgresql://app:p%40ss@db:5432/shop.
Errores relacionados
28000especificación de autorización no válida3D000la base de datos no existe53300demasiadas conexiones18456SQL Server: Error de inicio de sesión del usuario1045MySQL: acceso denegado para el usuarioORA-01017Oracle: nombre de usuario o contraseña no válidos; inicio de sesión denegado
El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.
Trabajar con PostgreSQL en SQLly
Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.