Erro 500 — Erro interno do servidor

O que significa o erro 500

O erro 500 indica um problema no servidor que impediu a conclusão da sua requisição. Diferente de erros 4xx (que indicam problema do lado do usuário), o 500 é um problema interno que geralmente é temporário ou precisa de intervenção da equipe técnica.

Passos imediatos para o usuário

1. Aguarde 10 segundos e recarregue a página (F5 ou Ctrl+R).
2. Tente novamente em 2-3 minutos. O problema pode ser temporário (deploy, reinicialização).
3. Limpe o cache do navegador (Ctrl+Shift+Del → selecione "Imagens e arquivos em cache").
4. Tente em modo anônimo (Ctrl+Shift+N) para descartar extensões e cookies corrompidos.
5. Teste em outro navegador para confirmar se o problema é geral ou específico do seu ambiente.

Situações comuns que causam erro 500

Quando reportar ao suporte

Se o erro persistir por mais de 5 minutos, abra um ticket informando:

• URL exata onde o erro ocorre (copie da barra de endereço).
• Ação que executava quando o erro apareceu (ex: "ao salvar um contato").
• Horário exato da ocorrência.
• Captura de tela com a mensagem de erro.
• Navegador e dispositivo que está usando.

Para administradores

Erros 500 são registrados nos logs do sistema com detalhes completos:

• Acesse Configurações → Avançado → Logs → Erros para ver a causa raiz e o stack trace.
• Verifique Observabilidade → Métricas para identificar se há picos de erros ou degradação de performance.
• Consulte Logs → Query se o erro estiver relacionado ao banco de dados.
• Configure alertas automáticos para ser notificado quando a taxa de erros 500 ultrapassar um limite.