HTTP 500 Internal Server Error — Causas e Correções

O que significa o HTTP 500

HTTP 500 Internal Server Error é a resposta genérica de "algo deu errado do nosso lado". A requisição chegou à aplicação, a aplicação falhou — uma exceção não tratada, uma configuração incorreta, uma dependência morta — e o servidor não tinha nada melhor a dizer.

Para os visitantes, um 500 não é culpa deles e raramente é corrigível pelo navegador. Para os desenvolvedores, sempre corresponde a uma entrada de log do lado do servidor; a correção começa encontrando esse stack trace.

Causas comuns de erros 500

Uma exceção não tratada no código da aplicação (referências nulas, erros de tipo, asserções falhas).
Configuração incorreta: diretivas quebradas do .htaccess ou nginx, permissões de arquivo erradas, variáveis de ambiente ausentes.
Uma dependência morta ou com timeout: banco de dados fora do ar, migrações ausentes, API externa falhando sem um fallback.
Esgotamento de recursos: sem memória, limites de PHP/worker, disco cheio.
Um deploy ruim: pacotes ausentes, versões incompatíveis de biblioteca, erros de sintaxe em código de produção.

Como corrigir como visitante

Recarregue uma vez após uma breve espera — muitos 500s são picos transitórios de deploy ou sobrecarga.
Volte mais tarde; a equipe do site geralmente sabe antes que você consiga avisá-los.
Limpe os cookies somente se o erro persistir especificamente para você e não para outros.

Como corrigir como desenvolvedor

Leia o log de erros do servidor — o stack trace é a resposta (log de erro do nginx/apache, log da aplicação, APM).
Reverta o último deploy primeiro se os erros começaram com ele.
Reproduza com a requisição exata que falhou a partir dos logs de acesso; adicione rastreamento de erros (Sentry & co.) se você não tiver nenhum.
Nunca exponha stack traces aos usuários em produção — registre os detalhes, mostre uma página amigável.

Exemplo de resposta

HTTP/1.1 500 Internal Server Error
Content-Type: text/html

<!doctype html>
<title>Something went wrong</title>

Impacto no SEO

500s sustentados fazem os mecanismos de busca desacelerarem o rastreamento e, se prolongados por semanas, podem retirar URLs afetadas do índice. Incidentes breves são inofensivos — o Google tenta novamente antes de decidir qualquer coisa.

Perguntas frequentes

Um erro 500 é minha culpa como visitante?

Não. É uma falha do lado do servidor. Esperar e recarregar é praticamente tudo o que você pode fazer.

Onde encontro o que causou um 500?

No log de erros do servidor ou no seu serviço de rastreamento de erros — todo 500 corresponde a uma exceção registrada ou erro de configuração.

Erros 500 afetam o SEO?

Interrupções curtas não afetam. Dias ou semanas de 500s reduzem o rastreamento e podem retirar temporariamente páginas do índice.