Connection refused ao banco significa que o cliente tentou abrir TCP (ou o protocolo configurado) e ninguém aceitou a conexão naquele host/porta — ou algo no caminho recusou explicitamente.
O que significa
Diferente de timeout (sem resposta) ou autenticação falha (servidor respondeu e rejeitou credencial), refused costuma indicar serviço parado, escutando em outro endereço/porta, ou bloqueio no caminho.
Por que acontece
- Processo do banco (PostgreSQL, MySQL, etc.) parado ou ainda iniciando
- Bind só em
127.0.0.1enquanto o cliente aponta para outro IP - Porta errada na string de conexão
- Firewall ou security group bloqueando a porta
Como diagnosticar
Confirme se a porta está em escuta no host do banco e se o cliente alcança esse host:
ss -tlnp | grep 5432
pg_isready -h host
Ajuste a porta/comando ao motor que você usa (5432 é exemplo comum de PostgreSQL). Verifique também a connection string e logs do serviço no servidor.
O que verificar se continuar
- Host e porta corretos do ponto de vista do cliente (container vs host)
- Regras de rede entre app e banco
- Se o banco escuta em socket Unix em vez de TCP
Relacionado: hub de erros.
DICA Postgres refused.
Continue explorando
Veja também o hub de conteúdo.