Causas mais comuns
- Erro no código, como uma variável vazia que o sistema não esperava
- Atualização de versão da linguagem ou de bibliotecas incompatível com o código
- Configuração errada ou ausente (no Laravel, o arquivo .env)
- Permissões de pastas no servidor (por exemplo, a pasta de cache ou de logs sem permissão de escrita)
- Banco de dados fora do ar ou consulta inválida
- Falta de memória ou tempo esgotado em uma operação pesada
O que verificar primeiro
| Pergunta | Por que ajuda |
|---|---|
| Acontece em todo o sistema ou em uma tela? | Erro geral sugere configuração ou servidor; pontual, código |
| Começou depois de alguma mudança? | Atualizações e publicações são a causa mais frequente |
| Acontece com todos os usuários? | Se não, pode depender de dados específicos |
| O que dizem os logs? | O log mostra o arquivo, a linha e a mensagem do erro |
Onde fica o log
Em sistemas Laravel, os erros ficam em storage/logs. Em outros sistemas PHP, no log do servidor web ou do PHP. Painéis de hospedagem costumam ter uma seção de logs. Nunca ative a exibição detalhada de erros para todos os usuários em produção (no Laravel, APP_DEBUG=true): ela expõe informações sensíveis.
Quem contratar
Um desenvolvedor da tecnologia do sistema, não um técnico de hospedagem genérico. A hospedagem ajuda quando o problema é do servidor, mas a maioria dos erros 500 está no código ou na configuração da aplicação. Veja como contratar um desenvolvedor para corrigir um sistema e, se o sistema é Laravel, como encontrar um especialista em Laravel.
Se o erro apareceu depois de uma atualização, veja funcionalidade parou após atualização. Corrigimos erros em sistemas existentes no nosso serviço de manutenção de sistemas PHP e Laravel.