// Referencia de errores de PostgreSQL

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
Categoría
Especificación de autorización no válida
Mensaje de error
password authentication failed for user "app"

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.conf requiere scram-sha-256, tras una actualización al valor predeterminado SCRAM.
  • El cliente tomó una contraseña diferente de PGPASSWORD o una .pgpass archivo.

Cómo solucionarlo

  1. Lee la entrada del registro del servidor correspondiente al inicio de sesión fallido; indica el motivo real.

  2. Establece una nueva contraseña como superusuario (en psql, \password app la pide sin mostrarla).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. Verifica cómo se almacena la contraseña. Un valor que comience con md5 debe restablecerse después de cambiar password_encryption a scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. Verifica qué pg_hba.conf lí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;
  5. 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

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.

// menos errores, correcciones más rápidas

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.