08001: sqlclient_unable_to_establish_sqlconnection

O que significa?

O cliente não conseguiu estabelecer uma conexão com o servidor PostgreSQL. A conexão falhou no nível de rede/endereço, antes de se tornar uma sessão.

Por que acontece?

Host/porta errados; um endereço em que o servidor não está escutando (conexão remota com listen_addresses = 'localhost'); o servidor está fora do ar/inacessível; um firewall bloqueia a porta (padrão 5432); ou falha na resolução de DNS. Um pool de conexões mal configurado também pode causá-lo.

Como resolver

Verifique se o servidor está no ar e escutando no endereço correto: confira listen_addresses = '*' (ou o IP correspondente) e a configuração de porta no postgresql.conf e reinicie o servidor (listen_addresses e port exigem reinicialização; um reload não basta). Teste o acesso a partir do cliente: psql -h host -p 5432 -U app_user. Libere 5432/tcp no firewall. Revise os valores de host/porta/DNS e a string de conexão.