Solución al error “failed: FATAL: Peer authentication failed for user "postgres" (Ubuntu)”

Descripción del Error

El mensaje de error “failed: FATAL: Peer authentication failed for user "postgres" (Ubuntu)” indica que el sistema no puede autenticar al usuario “postgres” utilizando el método de autenticación “peer”. Este error es común en sistemas que utilizan PostgreSQL en entornos Ubuntu y se produce cuando el sistema no puede verificar la identidad del usuario que intenta conectarse a la base de datos.

La autenticación “peer” permite que los usuarios de Unix se conecten a la base de datos sin necesidad de proporcionar una contraseña, siempre y cuando el nombre de usuario de la sesión coincida con el nombre de usuario de la base de datos. Si hay un desajuste, se produce este error.

Causas Comunes

Existen varias causas que pueden llevar a que se produzca este error:

1. Configuración incorrecta del archivo pg_hba.conf: Este archivo controla cómo los usuarios pueden conectarse a la base de datos y qué métodos de autenticación se utilizan.
2. Usuario incorrecto: El usuario que intenta conectarse no coincide con el usuario de la base de datos.
3. Problemas de permisos: Los permisos de la carpeta de datos de PostgreSQL pueden estar mal configurados, impidiendo el acceso al usuario.
4. Versión de PostgreSQL: La versión del servidor PostgreSQL puede no ser compatible con la configuración actual.
5. Falta de instalación de PostgreSQL: En algunos casos, PostgreSQL puede no estar instalado correctamente.

Métodos de Solución

A continuación, se describen varios métodos para solucionar el problema del error “failed: FATAL: Peer authentication failed for user "postgres" (Ubuntu)”.

Método 1: Verificar la configuración del archivo pg_hba.conf

1. Abra una terminal en su sistema Ubuntu.
2. Ingrese el siguiente comando para editar el archivo pg_hba.conf:
   bash
sudo nano /etc/postgresql/<version>/main/pg_hba.conf
   Reemplace <version> con la versión de PostgreSQL que está utilizando.
3. Busque la línea que contiene la configuración de “peer” para el usuario “postgres”. Debe verse algo así:
   local all postgres peer
4. Cambie “peer” a “md5” para permitir la autenticación mediante contraseña:
   local all postgres md5
5. Guarde los cambios y cierre el editor.
6. Reinicie el servicio de PostgreSQL para que los cambios surtan efecto:
   bash
sudo systemctl restart postgresql

Método 2: Cambiar el usuario de conexión

1. Si desea conectarse como un usuario diferente, asegúrese de que el nombre de usuario que utiliza coincida con el de la base de datos.
2. Intente conectarse utilizando el siguiente comando:
   bash
psql -U <nombre_usuario> -d <nombre_base_datos>
   Reemplace <nombre_usuario> y <nombre_base_datos> con los valores apropiados.

Método 3: Verificar los permisos de la carpeta de datos

1. Verifique los permisos de la carpeta de datos de PostgreSQL:
   bash
ls -ld /var/lib/postgresql/<version>/main
2. Asegúrese de que el usuario “postgres” tenga los permisos adecuados. Si no es así, ajuste los permisos:
   bash
sudo chown -R postgres:postgres /var/lib/postgresql/<version>/main
3. Reinicie el servicio de PostgreSQL:
   bash
sudo systemctl restart postgresql

Consejos de Prevención

Para evitar que este error se repita en el futuro, considere las siguientes recomendaciones:

• Mantenimiento Regular: Realice un mantenimiento regular del sistema y actualice PostgreSQL y sus configuraciones.
• Documentación: Mantenga una documentación clara sobre los cambios realizados en la configuración.
• Auditoría de Usuarios: Realice auditorías periódicas de los usuarios de la base de datos y sus permisos.
• Pruebas de Conexión: Realice pruebas de conexión después de cualquier cambio en la configuración.

Resumen

El error “failed: FATAL: Peer authentication failed for user "postgres" (Ubuntu)” puede ser frustrante, pero seguir los pasos adecuados puede resolverlo. Asegúrese de revisar la configuración del archivo pg_hba.conf, verificar el usuario de conexión y los permisos de la carpeta de datos. Siguiendo los métodos presentados en este artículo, podrá resolver el problema y evitar su recurrencia en el futuro.