Fale conosco
Dicas e Soluções

Magento com erro 500, 503 ou tela branca? Diagnóstico rápido

25/05/2025

devinstation

Magento com erro 500, 503 ou tela branca? Diagnóstico rápido

Se sua loja Magento apresenta erro 500, 503 ou apenas uma tela branca, o problema pode ser grave — mas muitas vezes tem solução simples. Esses erros são comuns e geralmente indicam falhas no servidor, permissões incorretas, conflitos de extensões ou falhas de cache. Neste artigo, você vai aprender como fazer um diagnóstico rápido e seguro para restaurar sua loja.

Entendendo os principais erros

Erro 500 (Internal Server Error)

O erro 500 no Magento significa que algo impediu o servidor de processar a solicitação. Pode ser causado por:

  • Permissões incorretas em arquivos ou pastas
  • Código com erro em módulos ou temas
  • Problemas no .htaccess ou PHP

Erro 503 (Service Temporarily Unavailable)

Esse erro costuma indicar que o Magento está em modo de manutenção ou que há falha na inicialização.

  • Arquivo maintenance.flag ativo
  • Falhas no deploy ou recompilação

Tela branca (White Screen of Death)

A tela branca geralmente representa um erro de PHP que não está sendo exibido por falta de configuração adequada.

  • Erros de sintaxe ou exceções não tratadas
  • Logs desabilitados

Diagnóstico rápido para erros no Magento

1. Ative o modo de desenvolvedor

No terminal, execute:

bin/magento deploy:mode:set developer

Isso permite exibir mensagens de erro completas no navegador.

2. Verifique os logs

Acesse os arquivos:

  • /var/log/system.log
  • /var/log/exception.log
  • /var/report/

Esses logs mostram a origem do problema (extensão, classe, linha de código etc.)

3. Corrija permissões

Permissões erradas podem gerar erro 500. Corrija com:

find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
chmod u+x bin/magento

4. Limpe cache e arquivos temporários

bin/magento cache:clean
bin/magento cache:flush
rm -rf var/cache/* var/page_cache/* var/view_preprocessed/*

5. Verifique o arquivo de manutenção (erro 503)

rm -f var/.maintenance.flag

6. Recompile e redeploy

Após alterações ou atualizações, use:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f

Causas comuns e como prevenir

  • Extensões de terceiros com bugs: utilize apenas plugins confiáveis
  • Atualizações mal feitas: sempre teste em staging antes
  • Mudanças em produção sem backup: mantenha um ponto de restauração
  • Servidores mal configurados: opte por hospedagens otimizadas para Magento

Como restaurar o site com segurança

  1. Acesse via SSH e consulte logs
  2. Faça backup dos arquivos e banco de dados
  3. Desative módulos suspeitos
bin/magento module:disable Nome_Do_Modulo
bin/magento setup:upgrade
  1. Teste após cada alteração
  2. Entre em contato com suporte técnico especializado se necessário

Conclusão

Erro 500, erro 503 ou tela branca no Magento não precisam ser um pesadelo. Com um diagnóstico rápido e técnico, você consegue identificar a causa raiz e resolver com segurança. Evite improvisos, mantenha boas práticas e monitore sua loja regularmente.

Posts Recentes