~ / hub / erros / Connection refused no banco
4 out 2026errosguia prático

Connection refused no banco

Porta do banco inacessível.

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.1 enquanto 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

← Erros · hub

Veja também o hub de conteúdo.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →