Suporte Magento: os erros mais comuns e como resolver

Algumas falhas aparecem com tanta frequência em lojas Magento que já têm causas conhecidas. Saber reconhecer os erros Magento mais comuns ajuda a descrever o problema ao suporte e a agir mais rápido. Veja os principais, o que costuma estar por trás de cada um e como resolver.

Página em branco ou erro 500

Geralmente indica um erro fatal no código: uma extensão incompatível, um deploy incompleto, falta de memória para o PHP ou permissões de arquivo incorretas. Os logs do servidor e do Magento (pasta var/log e relatórios em var/report) mostram a origem. A correção passa por reverter a última mudança ou corrigir o módulo que falhou.

Erro 503 ou loja presa em manutenção

O Magento entra em modo de manutenção durante deploys e atualizações. Se o processo for interrompido, a loja pode ficar presa nesse modo. O erro também pode vir do servidor ou do Varnish sem conseguir responder. É preciso concluir o deploy ou desativar o modo de manutenção depois de confirmar que tudo está em ordem.

Mudanças que não aparecem na loja

Preço alterado que não muda, produto novo que não aparece, layout antigo no lugar do novo. Quase sempre é cache ou indexação: o cache não foi limpo, os indexadores estão atrasados ou o cron está parado. Verificar o status dos indexadores e do cron resolve a maioria dos casos.

Indexadores travados

Indexadores que ficam muito tempo em processamento costumam ter relação com cron parado, falta de memória ou bloqueios no banco de dados. Em catálogos grandes, o modo “Atualizar por agendamento” e um cron bem configurado evitam o problema.

Falhas no checkout

• Meio de pagamento que some ou recusa pedidos: credenciais vencidas, problema de certificado ou mudança na API do parceiro.
• Frete que não calcula: falha na integração com a transportadora ou regras de frete conflitantes.
• Botão de finalizar que não responde: erro de JavaScript, geralmente causado por extensão ou script de terceiros.

Como envolve dinheiro, falha no checkout deve ser tratada como prioridade máxima.

E-mails que não saem

Pedidos sem e-mail de confirmação costumam ser problema de configuração de envio (SMTP), de fila de e-mails parada por causa do cron ou de bloqueio do provedor. Usar um serviço de envio transacional e monitorar a fila evita a falha.

Busca sem resultados

Se a busca ou as categorias param de mostrar produtos, o mecanismo de busca (OpenSearch ou Elasticsearch) pode estar fora do ar ou com o índice desatualizado.

O que ajuda o suporte a resolver mais rápido

Ao abrir um chamado, informe o horário em que o problema começou, a página afetada, a mensagem exibida, um print da tela e qualquer mudança recente. Erros que se repetem pedem uma investigação da causa, e não só a correção pontual. Conheça o suporte Magento da Zafarie.