Cómo solucionar el error FATAL: password authentication failed for user en PostgreSQL

La Solución Paso a Paso

1. 1

   Paso 1: Conectarse como usuario del sistema postgres mediante socket local

   En entornos Linux, el usuario superadministrador predeterminado de PostgreSQL (postgres) utiliza autenticación peer por defecto a través de sockets de UNIX locales. Accede directamente cambiando al usuario del sistema:

   BASH Copiar

   # Cambiar al usuario de sistema postgres e ingresar a psql
   sudo -u postgres psql
   

   Si el comando anterior funciona y te otorga acceso al prompt postgres=#, no hay ningún problema grave en el motor; el fallo se limita a la autenticación por contraseña vía TCP/IP.

2. 2

   Paso 2: Restablecer la contraseña del rol de PostgreSQL

   Desde la consola interactiva psql, asigna una nueva contraseña segura para el rol afectado (por ejemplo, postgres o tu usuario de aplicación):

   SQL Copiar

   -- Cambiar la contraseña del usuario postgres
   ALTER USER postgres WITH PASSWORD 'TuNuevaContraseniaSegura123!';
   

   Sal de la consola con \q.

3. 3

   Paso 3: Configurar el archivo de autenticación pg_hba.conf

   Abre el archivo de configuración de autenticación de clientes de PostgreSQL (pg_hba.conf). Puedes encontrar su ubicación exacta ejecutando SHOW hba_file; dentro de psql o buscando en /etc/postgresql/:

   BASH Copiar

   # Ejemplo para PostgreSQL 15/16 en Ubuntu/Debian
   sudo nano /etc/postgresql/16/main/pg_hba.conf
   

   Inspecciona las líneas de control de acceso para conexiones locales y TCP/IP (127.0.0.1/32 o ::1/128). Asegúrate de que utilicen scram-sha-256 o md5 en lugar de métodos restrictivos:

   CONFIG Copiar

   # TYPE  DATABASE        USER            ADDRESS                 METHOD
   # Conexiones locales por socket de UNIX
   local   all             postgres                                peer
   local   all             all                                     md5
   
   # Conexiones IPv4 en localhost (TCP/IP)
   host    all             all             127.0.0.1/32            scram-sha-256
   
   # Conexiones IPv6 en localhost
   host    all             all             ::1/128                 scram-sha-256
   

4. 4

   Paso 4: Recargar la configuración de PostgreSQL

   Aplica los cambios en pg_hba.conf recargando el servicio sin interrumpir las conexiones activas:

   BASH Copiar

   # Recargar la configuración en el servidor Linux
   sudo systemctl reload postgresql
   

   Prueba la conexión TCP pasando el parámetro -h localhost y -U postgres:

   BASH Copiar

   psql -h localhost -U postgres -W