Erro 404: como diagnosticar e corrigir

Erro 404 significa que o servidor recebeu uma requisição HTTP, mas não encontrou uma representação atual para aquele endereço. Não é falha de DNS nem conexão recusada: nesses casos, a resposta HTTP sequer chega. Para corrigir, descubra quem pediu a URL e onde a rota deixou de existir.

Primeiro confirme que é HTTP 404

O número exibido numa página bonita não prova o status. Abra o terminal e consulte apenas os cabeçalhos:

curl -I https://exemplo.com/caminho-a-testar

Para registrar somente o código final, seguindo redirecionamentos:

curl -sS -L -o /dev/null -w '%{http_code}\n' https://exemplo.com/caminho-a-testar

Uma resposta HTTP confirma que DNS, conexão e TLS avançaram o suficiente para falar com um servidor. Se o terminal mostra nome não resolvido, tempo esgotado, conexão recusada ou erro de certificado, a investigação pertence a outra camada.

Use o modo detalhado apenas quando precisar ver resolução, conexão, TLS e redirecionamentos:

curl -v https://exemplo.com/caminho-a-testar

Não publique a saída completa sem revisar. Cabeçalhos podem conter cookies, tokens, nomes internos e outros dados sensíveis.

O que a resposta 404 realmente diz

Pela semântica HTTP, o servidor de origem não encontrou uma representação atual para o recurso solicitado ou não quis revelar que ela existe. Isso não afirma se a ausência é temporária ou permanente.

O status pode vir do servidor web, framework, CMS, proxy, CDN ou aplicação. A página visual e o código HTTP são decisões separadas. Você pode oferecer navegação útil e ainda devolver o status correto.

Para conteúdo removido sem substituto, 404 é aceitável. Quando existe substituto equivalente, um redirecionamento permanente costuma preservar melhor a jornada. Não redirecione toda URL ausente para a página inicial; isso esconde links quebrados e cria destino sem relação.

Diagnóstico para quem visita

Confirme a grafia, remova parâmetros copiados desnecessariamente e navegue a partir da página inicial. Se apenas um link interno falha, reporte a página de origem e o endereço quebrado.

Teste janela privada para separar sessão e extensão. Se outra rede apresenta o mesmo 404, limpar DNS raramente ajuda: você já alcançou um servidor que respondeu HTTP.

Não repita atualização indefinidamente. Ela só ajuda quando uma implantação temporária está em andamento. Em site de terceiros, guarde URL, horário e captura da resposta para o suporte.

Diagnóstico para quem opera o site

Comece pelo acesso que gerou o erro. Registre método, host, caminho, parâmetros necessários, referenciador, horário, status e identificador de requisição. Mascare credenciais e dados pessoais.

Depois responda em ordem:

• a URL deveria existir ou o link está errado;
• o recurso foi movido, removido ou renomeado;
• o host correto recebeu a requisição;
• proxy e aplicação usam o mesmo prefixo de rota;
• arquivo e diretório existem com permissões adequadas;
• a implantação incluiu conteúdo e regras esperados;
• cache de borda conserva resposta antiga.

Compare ambiente que funciona com o que falha. Diferenças em barra final, maiúsculas, idioma, base path e codificação de caracteres são causas comuns. Linux costuma distinguir maiúsculas em nomes de arquivo; uma URL que funciona localmente pode falhar na produção.

Leia o registro antes de mudar configuração. Reiniciar serviço ou limpar cache sem hipótese pode apagar contexto e introduzir outro problema.

NGINX: faça a ausência virar 404 real

Para um site estático, a diretiva try_files pode procurar arquivo e diretório antes de devolver o status:

location / {
    try_files $uri $uri/ =404;
}

error_page 404 /404.html;
location = /404.html {
    internal;
}

Valide a sintaxe antes de recarregar:

nginx -t

Depois recarregue pelo mecanismo administrado no seu ambiente e teste uma URL existente e outra inventada. Não aplique try_files cegamente em aplicação que precisa encaminhar rotas ao framework; nesse caso, o fallback deve chamar a aplicação, que decide se o recurso existe.

Apache: personalize sem trocar o status

O Apache permite apontar uma página local com ErrorDocument:

ErrorDocument 404 /errors/not-found.html

Verifique a configuração:

apachectl configtest

Teste o endereço ausente depois da recarga. Use caminho local iniciado por barra. Um redirecionamento externo para a página de erro muda o fluxo e pode esconder o status original.

Em CMS ou framework, confira regras de reescrita antes do ErrorDocument. A requisição pode nunca alcançar o arquivo porque uma regra genérica entrega tudo ao controlador principal.

Soft 404: página de erro com sucesso HTTP

Soft 404 ocorre quando o conteúdo parece informar ausência, mas o servidor devolve sucesso. Também pode acontecer com página quase vazia ou redirecionamento irrelevante que um mecanismo de busca interpreta como erro.

Confira corpo e cabeçalho juntos:

curl -sS -D - https://exemplo.com/url-inexistente -o /dev/null

Se a aplicação mostra não encontrado e responde 200, ajuste o controlador ou template para emitir 404. Não resolva trocando apenas o texto da página. Robôs e clientes dependem do protocolo, não da aparência.

Uma página personalizada pode oferecer busca, categorias e início, desde que o status continue 404. Evite catálogo enorme, conteúdo principal duplicado ou publicidade que faça a ausência parecer uma página válida.

Efeito em busca sem alarmismo

URLs inexistentes fazem parte da manutenção normal. Mecanismos de busca deixam de considerar páginas que retornam erro repetidamente, mas um 404 isolado não significa punição geral do domínio.

O problema operacional aparece quando páginas importantes, links internos ou sitemap apontam para ausências. Corrija o link, restaure o recurso ou redirecione para substituto equivalente. Remova do sitemap o que não deve mais existir.

Soft 404 desperdiça rastreamento e confunde a decisão de indexação. Um status correto ajuda o robô a entender a ausência. Não existe benefício em devolver 200 para parecer saudável.

Monitore relatórios de rastreamento e registros do servidor, mas priorize URLs com tráfego, links internos, backlinks ou função de conversão. Lista longa de ataques a caminhos aleatórios não exige criar páginas para cada tentativa.

Corrija a causa, preserve a resposta

Uma boa página 404 ajuda a pessoa a sair do beco, mas a correção começa antes: link, rota, arquivo, implantação ou regra. Confirme a camada, preserve registros, mude o menor componente possível e teste o status. Barato demais vira chamado; diagnóstico sem evidência vira dois.