Solução de problemas

Localhost recusou a conexão

Conexão recusada normalmente significa que o navegador chegou ao computador, mas nada aceitou a conexão naquele host e porta.

Usar construtor de URL

Checklist rápido

  1. 1 Confira a URL exata, incluindo protocolo, host, porta e rota.
  2. 2 Confirme se o servidor local continua rodando no terminal ou gerenciador de serviços.
  3. 3 Teste a versão com IP de loopback, como http://127.0.0.1:3000/.
  4. 4 Verifique se outro processo já está usando a porta.
  5. 5 Leia o erro do terminal antes de mexer em firewall, navegador ou código.

Verificações rápidas

Trocar PORT pela porta real lsof -i :PORT

Se não aparecer processo, inicie o serviço ou corrija a porta. Cache do navegador não resolve listener ausente.

Perguntar direto ao servidor curl -v http://localhost:PORT/

Conexão recusada no curl confirma que o problema está abaixo do navegador.

Conferir protocolo http://localhost:PORT/

Usar https contra um serviço http local pode parecer falha de localhost.

Verificação de request em vivo

O que esta página vê

Detectando o que o servidor enxerga...
IP pública Verificando...
Linha da request Verificando...
Headers HTTP da request
Carregando headers...

Headers sensíveis, como cookies e tokens de autorização, são filtrados antes de aparecer.

O que significa conexão recusada

O navegador tentou conectar, mas nenhum processo aceitou a conexão naquele host e porta. Isso é diferente de 404 ou 500.

Caminho mínimo de correção

Inicie o servidor local, copie a URL exata do terminal e teste 127.0.0.1 se localhost parecer suspeito.

  • Porta incorreta é muito comum.
  • HTTPS contra HTTP falha.
  • Uma aba antiga pode continuar apontando para um serviço que já caiu.

Não misture tipos de erro

Conexão recusada, 404, erro SSL e tela em branco pedem diagnósticos diferentes. Classifique a mensagem antes de mudar o código.

Guias relacionadas de localhost

Solução de problemas

Localhost não funciona

Use uma checklist prática para localhost não funciona, não abre, porta incorreta, servidor parado, HTTPS e rotas 404.

Guia de porta

localhost:3000

Abra localhost:3000, entenda quais servidores usam a porta 3000 e resolva erros de conexão em React, Next.js e Node.

Guia de porta

localhost:8080

Abra localhost:8080 e entenda por que Java, Tomcat, Spring Boot, proxies e painéis locais usam esta porta.

Ferramenta para desenvolvedores

Consulta de portas localhost

Busque portas localhost comuns, entenda para que costumam ser usadas e copie comandos para verificar portas ocupadas.

FAQ

ERR_CONNECTION_REFUSED é problema do Chrome?

Normalmente não. Costuma ser problema de servidor local, porta ou protocolo. Use a URL impressa pelo servidor.

Firewall pode causar localhost recusou a conexão?

Pode, mas primeiro revise processo e porta. Em desenvolvimento, servidor parado ou porta errada é mais comum.

Conexão recusada é igual a 404?

Não. Conexão recusada significa que nada aceitou a conexão no host e porta. 404 significa que um servidor respondeu, mas a rota faltou.

Devo mudar firewall primeiro?

Normalmente não. Primeiro confirme processo, porta e protocolo. Firewall é mais comum quando outro dispositivo tenta acessar sua máquina.

Como saber se o problema é navegador ou servidor?

Teste 127.0.0.1, leia o terminal e rode lsof -i :PORT. Se nada escuta, o servidor precisa de atenção.