Dicas e Soluções

Cron Magento 2 não funciona? Recupere filas, e-mails e índices em 9 testes

Especialista investigando falha de cron do Magento 2 em ambiente de servidores

Cron Magento 2 não funciona? Recupere filas, e-mails e índices em 9 testes

Cron Magento 2 não funciona, acumula tarefas ou só executa quando alguém inicia o comando manualmente? A falha pode atrasar indexadores, e-mails, regras comerciais, geração de sitemaps e rotinas adicionadas por módulos. O problema nem sempre está no Magento: usuário incorreto, PHP CLI incompatível, sobreposição de processos e restrições do sistema operacional produzem sintomas semelhantes.

Antes de reinstalar o cron ou excluir registros da tabela cron_schedule, preserve as evidências. Anote quando o problema começou, quais rotinas foram afetadas e o que mudou recentemente. Os nove testes abaixo ajudam a encontrar a camada responsável sem transformar uma falha pontual em uma interrupção maior.

Cron Magento 2 não funciona: delimite o sintoma

Comece identificando o alcance da falha. Um cron completamente parado exige uma investigação diferente de um único job com erro. Verifique se a loja apresenta um ou mais destes sinais:

  • indexadores configurados por agendamento permanecem pendentes;
  • e-mails transacionais são enviados com atraso ou não saem;
  • regras de catálogo e carrinho não entram ou saem de vigência como esperado;
  • sitemaps, feeds ou integrações deixam de ser atualizados;
  • tarefas ficam com status pending, running, missed ou error por tempo excessivo;
  • o comando manual funciona, mas a execução automática não.

Confirme também se o defeito atinge todos os grupos de cron ou somente uma extensão. Essa separação evita culpar o agendador inteiro quando a origem é um job específico.

1. Preserve horário, contexto e alterações recentes

Registre o horário aproximado da primeira ocorrência, os jobs afetados e as últimas mudanças em módulos, PHP, servidor, permissões ou deploy. Não comece apagando var/log, limpando toda a tabela de agendamento ou reiniciando serviços indiscriminadamente.

Se o sintoma apareceu depois de uma publicação, compare os arquivos implantados, o composer.lock e a configuração do ambiente. Uma instalação incompleta também pode causar exceções durante o carregamento da aplicação.

2. Confirme se o agendamento existe no sistema operacional

Consulte a crontab com o mesmo usuário responsável pela aplicação:

whoami
crontab -l

Verifique o caminho absoluto do PHP, o diretório da loja, redirecionamentos de saída e o usuário configurado. Uma entrada criada para outro usuário pode existir sem conseguir acessar arquivos, gravar logs ou carregar as mesmas variáveis de ambiente utilizadas no terminal.

Não execute cron:install imediatamente. Primeiro preserve a configuração existente e confirme se há personalizações no agendamento. Reinstalar sem essa análise pode sobrescrever uma configuração operacional importante.

3. Compare o PHP da linha de comando

O servidor web e o cron podem utilizar binários, versões ou arquivos php.ini diferentes. Faça a comparação:

which php
php -v
php --ini
php -m

Confirme se o binário informado na crontab é o mesmo testado no terminal e se possui as extensões necessárias. Limites de memória, fuso horário e carregamento de extensões também podem mudar entre o PHP-FPM e o PHP CLI.

Quando o erro indicar classe ou pacote ausente, investigue as dependências antes de atualizá-las. O roteiro sobre erros do Composer no Magento 2 ajuda a localizar conflitos sem recalcular todos os pacotes.

4. Execute o cron manualmente com o usuário correto

No diretório raiz da aplicação, execute de forma controlada:

php bin/magento cron:run

Salve toda a saída e o código de retorno. Se o comando manual falhar, a mensagem pode apontar para permissões, dependências, banco de dados, memória ou um módulo. Se funcionar manualmente, mas não automaticamente, concentre a investigação na crontab, no usuário, no ambiente e no serviço de agendamento do sistema.

Evite iniciar várias execuções paralelas durante o teste. Processos concorrentes podem aumentar a carga e dificultar a identificação do job original.

5. Consulte os registros da tabela cron_schedule

Uma consulta somente de leitura mostra quais tarefas estão atrasadas ou falhando:

SELECT job_code, status, scheduled_at, executed_at,
       finished_at, messages
FROM cron_schedule
ORDER BY schedule_id DESC
LIMIT 100;

Procure padrões, não apenas um registro isolado. Muitos jobs em pending podem indicar que o agendador não está sendo chamado. Registros missed sugerem que a janela prevista passou sem execução. Um conjunto concentrado em error pode apontar para determinado módulo ou integração.

Um job em running não deve ser alterado diretamente sem confirmar se ainda existe um processo correspondente. Excluir registros para “destravar” a fila pode ocultar a causa e permitir execuções duplicadas.

6. Leia logs do Magento e do serviço de cron

Correlacione o horário encontrado na tabela com os arquivos em var/log, os registros do PHP e os logs do agendador do sistema operacional. Dependendo da distribuição e da infraestrutura, esses eventos podem estar no journal ou em arquivos próprios do serviço.

Procure a primeira exceção da sequência. Mensagens posteriores podem ser apenas consequência de banco indisponível, falta de memória, permissão negada ou carregamento incompleto da aplicação. Se o cron terminar com uma falha genérica do servidor, use também o roteiro de diagnóstico de erro 500 no Magento 2 para separar aplicação, PHP e infraestrutura.

7. Verifique processos sobrepostos e consumo de recursos

Consulte os processos ativos sem encerrá-los automaticamente:

ps aux | grep '[b]in/magento cron:run'
ps aux | grep '[p]hp'

Compare horário de início, duração, CPU e memória. Um job lento pode manter recursos ocupados e fazer as próximas tarefas acumularem. Antes de finalizar qualquer processo, confirme o PID, o comando, o usuário e se existe operação crítica em andamento.

Investigue também limites de memória, espaço em disco, inodes, conexões com o banco e latência das dependências. O cron pode estar configurado corretamente e ainda assim falhar porque outro componente não responde.

8. Isole o job ou grupo responsável

Se apenas uma família de tarefas falha, identifique o job_code, o módulo que o declarou e a frequência configurada. Revise os arquivos de configuração do módulo e procure exceções específicas nos logs. Jobs personalizados podem depender de APIs, credenciais, diretórios ou serviços externos.

Para indexadores em modo agendado, consulte:

php bin/magento indexer:show-mode
php bin/magento indexer:status

Não altere todos para execução em tempo real apenas para contornar o defeito. Isso muda o perfil de carga da loja sem corrigir o agendador. Se a fila de indexação estiver presa, siga o diagnóstico de reindexação do Magento 2.

9. Valide a correção com evidências

Depois de corrigir a causa, acompanhe mais de um ciclo de execução. Confirme que novos registros são criados e transitam de pending para running e success, sem crescimento contínuo de tarefas atrasadas.

Valide os efeitos funcionais relevantes: atualização de preços e estoque, envio de e-mails controlados, aplicação de regras, geração de arquivos e integrações. Registre o que foi alterado, os comandos executados e o critério utilizado para encerrar o incidente.

Se cache ou sessões também apresentarem instabilidade durante a investigação, trate essa camada separadamente com os testes de Redis no Magento 2. Corrigir vários componentes ao mesmo tempo impede saber qual alteração resolveu o problema.

O que evitar durante o diagnóstico

  • apagar toda a tabela cron_schedule sem backup e análise;
  • executar várias instâncias manuais simultaneamente;
  • reinstalar a crontab sem preservar as entradas existentes;
  • alterar permissões recursivamente sem entender o usuário correto;
  • desativar módulos diretamente em produção para “testar”;
  • reiniciar banco, PHP e cache ao mesmo tempo, apagando a relação entre causa e efeito.

Perguntas frequentes sobre cron Magento 2

Como saber se o cron do Magento 2 está rodando?

Consulte a crontab, execute php bin/magento cron:run de forma controlada e verifique os registros recentes da tabela cron_schedule. Jobs avançando até success indicam execução; acúmulo em pending, missed ou error exige investigação.

Posso apagar a tabela cron_schedule para destravar o Magento?

Não como primeira medida. A exclusão indiscriminada remove evidências, pode afetar tarefas ainda válidas e não corrige a origem. Identifique o job, confirme processos ativos e faça backup antes de qualquer manutenção.

Por que o cron funciona manualmente, mas não automaticamente?

As causas mais comuns estão no usuário da crontab, caminho do PHP, variáveis de ambiente, permissões ou serviço de agendamento. Compare exatamente o comando automático com aquele executado no terminal.

O cron parado pode afetar o checkout?

Pode afetar rotinas relacionadas a regras, integrações, filas e tarefas adicionadas por módulos, mas nem todo erro de checkout vem do cron. Correlacione horário, job e logs antes de concluir que existe relação.

Conclusão

Quando o cron Magento 2 não funciona, a correção segura começa pela separação entre falha geral, problema do sistema operacional e erro de um job específico. Preserve logs, compare o PHP CLI, consulte a fila e valide a recuperação durante mais de um ciclo.

Se tarefas continuarem acumulando ou se a investigação envolver módulos e infraestrutura, uma análise técnica especializada pode reduzir o risco de execuções duplicadas e indisponibilidade. A equipe do SuporteMagento.com.br pode apoiar o diagnóstico e a estabilização da operação.