Problemas con la conexión del Cliente

Una vez que tiene el postmaster en ejecución, al tratar de conectar con él mediante una aplicación cliente puede producirse un fallo por varias razones. Los ejemplos de mensajes de error mostrados aquí son para clientes basados en las versiones recientes de libpq; los clientes basados en otras bibliotecas de interfaz pueden producir otros mensajes, com más o menos información.

connectDB() -- connect() failed: Connection refused
Is the postmaster running (with -i) at 'server.joe.com' and accepting connections on TCP/IP port '5432'?
    
Este el es fallo genérico de 'No puedo encontrar un postmaster con el que comunicarme'. Puede ocurrir algo así cuando se intenta una comunicación TCP/IP o mediante socket Unix con un postmaster local:
connectDB() -- connect() failed: No such file or directory
Is the postmaster running at 'localhost' and accepting connections on Unix socket '5432'?
    
La última línea es útil para verificar que el cliente está tratando de conectar donde se supone que debe hacerlo. Si en realidad no hay ningún postmaster ejecutándose allí, el mensaje de error del núcleo será del tipo de 'Conexión rehusada' o de 'No existe el fichero o directorio', como los anteriores. (Es particularmente importante tener en cuenta que 'Conexión rehusada' en este contexto no no significa que el postmaster haya recibido la petición de conexión y la haya rechazado; en este caso se produce un mensaje diferente, como se verá.) Otros mensajes de error, como el de "Connection timed out" sí indican problemas más importantes, como la falta de conectividad en la red.

No pg_hba.conf entry for host 123.123.123.123, user joeblow, database testdb
    
Esto es lo más probable que obtenga si consigue contactar con un postmaster, pero éste no quiere hablar con usted. Como sugiere el mensaje, el postmaster rehusa la petición de conexión porque no encuentra un renglón de autorización en su fichero de configuración pg_hba.conf

Password authentication failed for user 'joeblow'
    
Los mensajes como éste indican que ha contactado con el postmaster, y éste está dispuedto a hablar con usted, pero no lo hará hasta que supere el método de autorización especificado en el fichero pg_hba.conf. Compruebe la clave que está enviando, o su programa IDENT o Kerberos, si el mensaje de error menciona alguno de esos tipos de autentificación.

FATAL 1:  SetUserId: user 'joeblow' is not in 'pg_shadow'
    
Esta es otra variante de fallo de autentificación: no se ha ejecutado la orden de Postgres 'create_user' para el nombre de usuario indicado.

FATAL 1:  Database testdb does not exist in pg_database
    
No hay base de datos con ese nombre bajo el control de ese postmaster. Nótese que si no especifica el nombre de la base de datos, se aplica por defecto su nombre de usuario en Postgres, lo que puede no ser lo correcto.