Ao enfrentar um erro 500 no Magento, ativar logs detalhados é essencial para entender a causa e resolver rapidamente, evitando que sua loja fique fora do ar por tempo indeterminado. O erro 500 (Internal Server Error) é genérico e indica que algo falhou no servidor, mas não revela detalhes — o que torna a análise de logs um passo obrigatório para o diagnóstico correto.
Neste artigo, você vai aprender como identificar a origem do erro 500 no Magento 2, ativar logs detalhados, interpretar mensagens de erro e agir com segurança para restaurar sua loja.
O que é o erro 500 no Magento?
O erro HTTP 500 é um erro interno do servidor. No Magento, ele pode ocorrer por:
- Permissões de arquivo incorretas
- Falhas em extensões ou temas personalizados
- Problemas na compilação do sistema (
setup:di:compile) - Falhas no cache ou ausência de arquivos estáticos
- Conflitos com módulos de terceiros
Como o navegador não exibe detalhes do erro, o administrador precisa acessar os logs do Magento e do servidor para entender a origem.
Como ativar logs detalhados no Magento 2
1. Verifique se o modo developer está ativo
O modo developer permite a exibição e o registro de erros com mais detalhes.
No terminal, execute:
php bin/magento deploy:mode:show
Se o modo estiver em produção, altere para developer com:
php bin/magento deploy:mode:set developer
⚠️ Atenção: altere o modo apenas em ambiente de desenvolvimento. Em produção, o ideal é habilitar apenas os logs sem exibir erros na tela.
2. Ative o log no arquivo env.php
Acesse o arquivo app/etc/env.php e adicione (ou altere) a linha:
phpCopiarEditar'log' => [
'active' => true,
],
Isso garante que o Magento irá registrar todas as exceções, erros de sistema e falhas personalizadas.
3. Verifique os principais arquivos de log
Os arquivos de log ficam na pasta var/log/. Os mais úteis são:
- system.log: registra eventos gerais do sistema
- exception.log: registra exceções PHP e falhas específicas
- debug.log (se ativado): mostra informações detalhadas de módulos
Também vale verificar:
var/report/
Esse diretório armazena relatórios numerados que contêm stack traces de falhas graves.
Você pode usar o comando:
tail -f var/log/exception.log
Para acompanhar os erros em tempo real durante o acesso à loja.
Logs do servidor também ajudam no diagnóstico
Além dos logs do Magento, o servidor web (Apache ou Nginx) também registra erros importantes. Confira os caminhos mais comuns:
- Apache:
/var/log/apache2/error.log - Nginx:
/var/log/nginx/error.log
Procure mensagens com timestamps correspondentes ao horário do erro 500.
Erros comuns que geram erro 500 no Magento
1. Permissões incorretas
Arquivos com permissões erradas causam bloqueio no carregamento. Corrija com:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
chmod u+x bin/magento
2. Erro na compilação (DI Compile)
Se a compilação de dependências falhar, o Magento pode exibir erro 500. Recomenda-se:
php bin/magento setup:di:compile
Corrija mensagens de erro durante o processo.
3. Falha em extensões de terceiros
Ao instalar ou atualizar extensões, um código mal escrito pode causar falhas. Verifique os logs e, se necessário, desative o módulo problemático:
php bin/magento module:disable Nome_Modulo
php bin/magento setup:upgrade
Como resolver com segurança
- Ative logs e leia as mensagens detalhadamente
- Reproduza o erro em ambiente de homologação
- Faça backup antes de modificar arquivos
- Corrija permissões e cache
- Considere desativar extensões recentes se o erro for novo
- Monitore continuamente os logs após correções
👉 Veja também:
Magento com erro 500, 503 ou tela branca: diagnóstico rápido
Conclusão: logs são seu melhor aliado contra erro 500 no Magento
Quando ocorre o erro 500 no Magento, não há tempo a perder. Ativar os logs detalhados permite um diagnóstico rápido e preciso, revelando a verdadeira causa por trás do problema. Com acesso aos logs certos e uma leitura estratégica, você reduz o tempo de indisponibilidade e evita prejuízos no faturamento.
