Solução de problemas

Localhost não funciona

Problemas de localhost quase sempre vêm de quatro pontos: serviço parado, porta incorreta, protocolo incorreto ou rota ausente.

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

Comparar localhost e loopback curl -I http://127.0.0.1:PORT/

Se a IP numérica funciona e localhost não, revise hosts file, IPv6, bind address ou certificados.

Encontrar processo ativo lsof -i :PORT

Separe problema do navegador de servidor ausente ou conflito de porta.

Usar a URL impressa http://localhost:PORT/path

Muitas falhas vêm de copiar uma porta ou rota de tutorial em vez da saída atual do projeto.

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.

Leia primeiro o tipo de erro

Conexão recusada, DNS, SSL, tela em branco e 404 apontam para causas diferentes. O texto do navegador ajuda a escolher o próximo teste.

O terminal é a fonte de verdade

A maioria dos dev servers imprime a URL local exata. Copie essa linha antes de adivinhar porta, protocolo ou rota.

Mapa rápido

Classifique a mensagem antes de mudar código, firewall ou configuração global.

  • ERR_CONNECTION_REFUSED: nada aceitou a conexão.
  • 404 not found: servidor respondeu, mas a rota não existe.
  • SSL protocol error: navegador provavelmente usou https contra serviço http.
  • Tela em branco: frontend carregou, mas API, dados ou build podem ter falhado.

Guias relacionadas de localhost

Solução de problemas

Localhost recusou a conexão

Resolva localhost recusou a conexão revisando processo, URL, porta, protocolo, firewall e logs locais.

Comparação

localhost vs 127.0.0.1

Compare localhost e 127.0.0.1, entenda endereços loopback e aprenda quando um funciona e o outro falha.

Guia de digitação

Corretor de erros localhost

Corrija erros comuns como locallhost, localhos, lcoalhost, localhost.com, http localhost e https localhost.

Ferramenta para desenvolvedores

Construtor de URL localhost

Crie URLs localhost com protocolo, host, porta e rota corretos; compare localhost, 127.0.0.1 e IP LAN.

FAQ

Por que localhost funciona em um projeto e em outro não?

Cada projeto pode usar outra porta, rota, framework ou protocolo. Leia o terminal do projeto ativo.

Por que localhost.com não funciona igual a localhost?

localhost é um hostname local especial. localhost.com é um domínio público diferente.

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.