Erro 404 Not Found: o que significa e como corrigir

O que este erro significa e como reconhecê-lo

• Uma página exibe 404, Not Found ou uma mensagem personalizada de página não encontrada, enquanto outras páginas do mesmo site carregam normalmente.
• Uma requisição de API retorna 404 mesmo que o hostname e o servidor estejam acessíveis.
• Uma URL que funcionava anteriormente começa a retornar 404 após um deployment, uma migração, uma alteração de permalink ou uma atualização da aplicação.
• Resultados de busca, favoritos ou links internos levam a conteúdo que não está mais disponível.
• Vários caminhos não relacionados falham após uma alteração na configuração do servidor web, reverse proxy ou rewrite.

Causas principais, por probabilidade

Causas prováveis, das mais comuns às menos comuns:

1. URL digitada incorretamente ou incompleta: Um erro de ortografia, um segmento de caminho ausente ou o uso incorreto de maiúsculas e minúsculas aponta para um recurso que não existe.
2. Conteúdo excluído ou movido: A página ou o arquivo foi removido, renomeado ou realocado sem um redirect relevante.
3. Link interno ou externo quebrado: Um link ainda referencia uma URL obsoleta, geralmente após uma migração ou alteração na estrutura de URLs.
4. Rota de aplicação ausente: A aplicação publicada não define a página ou o endpoint de API solicitado, ou o caminho usa a versão ou o prefixo incorreto da API.
5. Regras incorretas de rewrite ou permalink: O Apache, o Nginx, um roteador de framework ou uma configuração de CMS não consegue encaminhar um caminho válido ao handler pretendido.
6. Problema de deployment ou document root: Um arquivo, uma rota ou o resultado do build não foi publicado, ou o servidor está servindo um diretório diferente do esperado.
7. Incompatibilidade no reverse proxy: Um proxy ou gateway envia a requisição para a aplicação ou o backend errado, onde esse caminho é desconhecido.
8. Diferença no uso de maiúsculas e minúsculas do caminho: Uma URL que funciona em um ambiente pode falhar em um sistema de arquivos ou servidor que diferencia maiúsculas de minúsculas quando a capitalização não corresponde à rota ou ao nome do arquivo.

Como corrigir

Se você está visitando o site

1. Verifique novamente o endereço, incluindo ortografia, capitalização, hifens, extensões de arquivo e cada segmento do caminho.
2. Remova o segmento final suspeito do caminho ou navegue a partir da página inicial do site e da busca integrada para localizar a página atual.
3. Se a página foi acessada por um favorito ou resultado de busca, procure uma versão mais recente do conteúdo em vez de atualizar repetidamente a mesma URL.
4. Informe ao responsável pelo site sobre um link confiável quebrado, fornecendo a URL exata e a página onde você o encontrou.

Se você administra o site

1. Confirme a requisição que falha. Registre o caminho exato, o método HTTP, o host, a query string e o horário da falha. Verifique se o problema afeta uma URL, uma família de rotas ou o site inteiro.
2. Decida se o recurso deveria existir. Verifique o registro de conteúdo, os arquivos publicados ou a definição da rota da aplicação. Um recurso removido deliberadamente normalmente deve continuar retornando 404, a menos que exista uma substituição realmente relevante.
3. Compare um caminho que falha com um que funciona. Procure diferenças na capitalização, nas barras finais, nas extensões de arquivo, nos prefixos de locale, na versão da API, no prefixo da rota e no tratamento de query strings.
4. Examine a configuração de roteamento e rewrite. Revise o roteador da aplicação, os permalinks do CMS, as regras do servidor web, o document root e os mapeamentos do reverse proxy. Faça alterações de configuração somente com a autorização adequada, depois de preservar a configuração atual e considerar o efeito sobre outras rotas.
5. Verifique o deployment. Confirme se o arquivo esperado, o resultado do build, a rota e os assets estáticos foram incluídos na versão publicada e se o servidor ativo está usando a versão pretendida.
6. Revise os logs. Use os logs do servidor web, do proxy e da aplicação para determinar qual componente gerou o 404 e se a requisição chegou ao backend esperado. Remova ou oculte credenciais, tokens e dados pessoais antes de compartilhar os logs.
7. Corrija links ou redirects. Atualize os links internos para o caminho atual. Se o conteúdo foi movido permanentemente, configure um redirect permanente autorizado para o destino equivalente mais próximo. Não redirecione URLs ausentes e não relacionadas para a página inicial.
8. Verifique a resposta de erro. Faça uma requisição à URL ausente original e confirme que ela retorna o status HTTP 404. Uma página de erro personalizada pode ser útil, mas não deve transformar um recurso ausente em uma resposta 200 bem-sucedida e enganosa.
9. Teste novamente os caminhos afetados. Verifique a URL original, a URL de substituição, se houver, rotas funcionais representativas e métodos de API relevantes após a alteração. Monitore os logs de 404 depois disso para identificar links quebrados remanescentes.

Prevenção e como verificar a correção

• Execute verificações de links quebrados antes e depois de migrações, redesigns e alterações na estrutura de URLs.
• Mantenha redirects documentados para conteúdos importantes que sejam movidos permanentemente.
• Teste rotas representativas de páginas, assets e APIs como parte de cada deployment.
• Trate a capitalização dos caminhos, as barras finais, os prefixos de locale e as versões da API como decisões explícitas de roteamento.
• Mantenha a configuração de roteamento do servidor web, do reverse proxy e da aplicação sob controle de mudanças.
• Monitore os caminhos 404 solicitados com frequência para identificar links internos quebrados, integrações desatualizadas e solicitações recorrentes dos usuários.
• Preserve URLs estáveis para conteúdos que devem continuar disponíveis ou indexados.
• Garanta que os templates de erro personalizados mantenham o status HTTP correto.

Perguntas frequentes