O que significa
O servidor encontrou uma condição inesperada e não conseguiu concluir a requisição. É um código genérico para erros do lado do servidor.
Causas comuns
- Exceção não tratada ou bug no código da aplicação
- Configuração errada, como um .htaccess inválido ou variável de ambiente ausente
- Falha de banco de dados ou dependência não mapeada para um status melhor
Como resolver
Se você é o cliente ou visitante
Tente de novo mais tarde; se persistir, informe o horário e qualquer id de requisição da resposta.
Se você mantém o site ou a API
Verifique os logs de erro da aplicação e do servidor, corrija a exceção e retorne códigos mais específicos (502, 503, 504) quando a causa for conhecida.
Resposta de exemplo
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
}Especificação
Perguntas frequentes
› Como encontro a causa de um 500?
Procure o stack trace no log de erros do servidor ou da aplicação no horário da requisição; ative o modo debug só em desenvolvimento.
› Um arquivo .htaccess pode causar 500?
Sim. Um erro de sintaxe ou diretiva desconhecida no .htaccess faz o Apache responder 500.