PostgreSQL 08001: não foi possível estabelecer conexão
O cliente não conseguiu abrir uma conexão com o servidor: nada escutando nesse host e porta, um firewall, DNS ou um timeout.
- SQLSTATE
08001- Nome
sqlclient_unable_to_establish_sqlconnection- Categoria
- Exceção de conexão
O que significa
08001 é um SQLSTATE do lado do cliente: drivers como PgJDBC e Npgsql relatam isso quando não conseguem estabelecer uma conexão, e ferramentas baseadas em libpq exibem mensagens como a acima. O servidor nunca viu uma tentativa de login, então o problema está no caminho da rede ou no servidor não escutando, não nas credenciais.
O erro do sistema operacional no final indica qual: Connection refused significa que o host respondeu, mas nada está escutando nessa porta; timeout expired ou Operation timed out geralmente significa que um firewall descartou os pacotes; could not translate host name é DNS.
Causas comuns
- O servidor PostgreSQL não está em execução ou está escutando em outra porta.
listen_addressesélocalhost(o padrão), então o servidor só aceita conexões locais.- Um firewall, grupo de segurança ou mapeamento de porta do Docker bloqueia a porta 5432.
- Nome de host errado ou um nome de host que não resolve a partir do cliente.
- Conectando-se a
localhostdentro de um contêiner, que se refere ao próprio contêiner.
Como corrigir
-
No servidor, verifique se o PostgreSQL está em execução e em quais endereços e porta ele escuta.
SHOW listen_addresses; SHOW port;
-
Permitir conexões de rede: defina
listen_addresses = '*'(ou o endereço do servidor) empostgresql.confe reinicie, depois adicione umapg_hba.confregra para os clientes. -
Teste o caminho de rede a partir do cliente, por exemplo
pg_isready -h db.example.com -p 5432, e abra a porta no firewall ou grupo de segurança. -
De dentro de um contêiner, conecte-se ao nome de serviço do contêiner do banco de dados ou ao endereço do host em vez de
localhost.
Erros relacionados
08006falha de conexão28000especificação de autorização inválida57P03não é possível conectar agora2003MySQL: não é possível conectar ao servidor MySQL no host2002MySQL: não é possível conectar via socketORA-12541Oracle: TNS: não há listener
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.