Como solucionar erros HTTP 500, 502 e 503
Atualizado: 21 de abril de 2026 · Pela equipe editorial do Verificador de Sites
Erros 5xx indicam falha no lado do servidor, mas cada código aponta para uma camada de falha diferente. Este guia ajuda você a isolar a camada rapidamente.
Triagem rápida (primeiros 5 minutos)
- Execute a URL no Verificador de Sites para capturar status e tempos.
- Confirme se o problema afeta um caminho de URL ou todos os endpoints.
- Verifique se o erro é estável ou intermitente.
- Correlacione com implantações, alterações de configuração ou picos de tráfego.
500 Internal Server Error
Falha genérica de app/servidor. Causas mais comuns: exceção de aplicação não capturada, variável de ambiente incorreta, problema de permissão ou chamada de dependência com falha.
- Revise primeiro os logs da aplicação e depois os do servidor web.
- Verifique releases e migrações recentes.
- Valide permissões de arquivo e segredos de runtime.
502 Bad Gateway
Geralmente um problema de proxy/gateway entre Nginx/Apache/balanceador de carga e seu app upstream.
- Confirme se o processo upstream está em execução e escutando no host/porta esperados.
- Verifique timeout do proxy e incompatibilidades de keepalive.
- Valide o DNS upstream em implantações em contêineres.
503 Service Unavailable
Serviço temporariamente indisponível, muitas vezes por sobrecarga, modo de manutenção ou pools de workers esgotados.
- Inspecione saturação de CPU, memória e pools de conexão.
- Verifique eventos de autoscaling e limitação de taxa.
- Valide flags de manutenção ou health checks mal configurados.
O que enviar em escalações de suporte
- URL + código de status exato
- Carimbo de data/hora da primeira observação (UTC preferível)
- Se o problema é global ou específico de região
- Qualquer implantação ou alteração de infraestrutura recente
Para falhas do lado DNS, consulte nosso guia de propagação DNS. Para falhas de incompatibilidade de host em certificados, consulte este guia SSL.