~ / hub / erros / Erro 404 Not Found — guia completo
27 set 2026errosguia completo

Erro 404 Not Found — guia completo

404 em estático, SPA, API e CDN: como achar a camada certa e corrigir.

1. Quatro camadas possíveis

  1. CDN / objeto — arquivo não publicado ou path errado
  2. Proxy — location não cobre a URL
  3. SPA — refresh em rota client-side sem fallback
  4. API — rota inexistente, método errado ou versão /v1 esquecida

2. SPA: o erro clássico no refresh

Ususuário abre /dashboard direto. O servidor procura um arquivo físico e devolve 404. Solução: fallback para index.html.

# Nginx
location / {
  try_files $uri $uri/ /index.html;
}

3. API: responda JSON previsível

curl -i https://api.exemplo.com/v1/pedidos/999
# Ideal: 404 com corpo {"error":"not_found","id":"999"}
BOA PRÁTICA Não devolva a home de marketing como 404 de API — o client precisa de status e corpo claros.

← erros · rotas no React

Quer aplicar isso no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar diagnóstico →