Um post agendado não publicou? O backup previsto não apareceu? Antes de desativar o WP-Cron no WordPress ou mudar a hospedagem, descubra qual tarefa atrasou, desde quando e em qual fila ela está. Um atraso isolado num site com poucas visitas é diferente de vários eventos vencidos por horas.
Este guia prioriza observação e logs, sem orientar a execução manual, exclusão ou pausa de tarefas. Em lojas WooCommerce, ações ligadas a pedidos, pagamentos, frete e integrações podem ter efeitos reais; até visitas ao painel podem iniciar o processamento normal da fila. Faça o diagnóstico com acesso autorizado e envolva o responsável pela loja quando necessário.
O que é WP-Cron e por que uma tarefa atrasa?
WP-Cron é o mecanismo de agendamento do WordPress. O núcleo o usa, por exemplo, para verificar atualizações e publicar posts programados; plugins também cadastram eventos. Diferentemente do cron de um servidor, ele não funciona como relógio independente: verifica eventos vencidos quando requisições executam o WordPress. Sem uma requisição que acione esse mecanismo no horário previsto, a execução pode atrasar.
O arquivo wp-cron.php participa do processo, mas abrir sua URL no navegador não é um teste conclusivo: uma página em branco ou resposta HTTP não prova que uma tarefa específica rodou e terminou bem. Requisições internas bloqueadas, limites do servidor ou falhas no código da rotina também podem explicar atrasos. Uma página entregue integralmente por cache ou CDN pode não executar o PHP do WordPress; nem toda visualização é um gatilho garantido. Entenda essa camada no guia de configuração de cache no WordPress — sem desligar o cache de produção só para testar cron.
Antes de investigar: acesso, horários e backup
Tenha exemplos com horário agendado e horário observado, acesso autorizado ao painel e o nome do plugin responsável pela rotina. Confira o fuso do site em Configurações > Geral; painéis de plugins ou da hospedagem podem exibir outro fuso. Para analisar logs e cron do servidor, peça acesso ao provedor ou apoio técnico. Não compartilhe dados de clientes nem URLs com credenciais em chamados públicos.
Observar telas e registros não exige editar arquivos, embora a visita ao painel possa acionar o processamento normal de algumas filas. Antes de instalar plugin auxiliar, editar wp-config.php, mudar o cron do servidor ou realizar testes que produzam emails, pedidos ou cobranças, faça um backup completo e restaurável de arquivos e banco e, se possível, teste em staging. Isole emails, webhooks e gateways de cobrança reais no ambiente de teste. Sem backup confiável ou responsável pelos fluxos financeiros, pare antes de fazer alterações.
Checklist: como diagnosticar tarefas agendadas no WordPress
1. Registre o sintoma sem presumir a causa
Anote horário previsto, horário observado e frequência do atraso. Separe publicação de posts, backup, relatórios, emails, sincronizações e ações WooCommerce. No plugin de backup, distinga tarefa não iniciada, tarefa iniciada com erro e tarefa concluída sem cópia entregue. Um backup falho não prova, sozinho, falha do gatilho WP-Cron.
2. Confira a Saúde do site
No painel, abra Ferramentas > Saúde do site > Status e procure avisos de eventos agendados. Registre o texto do alerta e quando ele surgiu. O teste do WordPress pode apontar eventos atrasados ou órfãos, mas não verifica o sucesso de todos os callbacks: sem alerta não significa backup, email ou integração concluídos. Os nomes dos menus variam conforme idioma e versão.
3. Inspecione eventos se precisar de detalhe
Se sua hospedagem não oferece uma visão adequada e a política do site permite a instalação, o WP Crontrol no diretório oficial exibe eventos em Ferramentas > Cron Events (nome traduzido pode variar). Após backup e checagem de compatibilidade, observe hook, próxima execução, recorrência e avisos. Identifique o plugin dono do evento por documentação ou suporte; o nome do hook, sozinho, pode enganar.
Não use “Executar agora”, “Excluir” ou “Pausar” como teste. O WP Crontrol também permite ações que alteram a fila; um clique pode iniciar backup pesado, email repetido ou processo comercial. Se você não pode instalar plugins, peça à hospedagem ou a um desenvolvedor um relatório dos eventos por ferramentas apropriadas, sem intervir na produção.
4. Compare as evidências
| Sinal observado | Hipótese, não diagnóstico fechado | Próximo passo seguro |
|---|---|---|
| Post programado atrasa em site com poucas requisições e publica depois | Gatilho chegou tarde | Confira horários e fuso; monitore a recorrência antes de alterar o cron. |
| Vários eventos seguem vencidos mesmo com requisições que executam WordPress | Gatilho interno, configuração alternativa, bloqueio ou limitação do host | Solicite à hospedagem análise de loopback, logs, limites e cron externo; não desative o WP-Cron às cegas. |
| Só uma rotina específica falha | Erro do plugin, credencial externa, callback ou recurso | Confira o log da rotina e consulte seu fornecedor com hook e intervalo do problema. |
| Backup aparece como concluído, mas cópia não chega | Falha no destino, espaço ou transferência | Confira logs e o destino de armazenamento antes de mexer no agendador. |
| Email não chega apesar de ação concluída | Transporte, entrega ou regra de notificação | Verifique status do pedido, notificações e entrega separadamente do cron. |
Se cache, firewall ou hospedagem mudaram recentemente, inclua isso no chamado. Nosso guia de hospedagem WordPress ajuda a avaliar suporte e recursos, mas a solução depende da configuração do seu ambiente.
WooCommerce: examine o Action Scheduler separadamente
Numa loja WooCommerce, procure WooCommerce > Status > Scheduled Actions (ou a tradução correspondente, se disponível). O Action Scheduler mantém uma fila de ações usada pelo WooCommerce e por extensões. Por padrão, seu processamento pode começar via WP-Cron e também em requisições administrativas; há outras formas de iniciá-lo. Essa fila não é a mesma lista de eventos WP-Cron: o disparo do agendador não garante que cada ação tenha terminado.
Filtre ações pendentes, em andamento e com falha; examine data, hook, grupo e logs da rotina afetada. Um pequeno atraso pode ser normal, mas acúmulo de ações antigas ou falhas repetidas merece investigação. Não execute ações em lote nem repita ações de pagamento, frete ou assinatura sem entender se já produziram efeito externo. Para intervenções na loja, siga também o checklist de atualização segura do WooCommerce.
Nem toda notificação por email é agendada: algumas saem em resposta a mudanças no pedido, dependendo do plugin e da configuração. Verifique status, regra de notificação, envio e entrega no guia de emails do WooCommerce que não chegam. Evite alterar pedidos reais ou enviar mensagens de teste a clientes sem procedimento controlado.
Quando considerar cron do servidor — e quando não mexer
Um agendador do servidor pode chamar o wp-cron.php periodicamente, sem depender das visitas públicas. Não comece adicionando DISABLE_WP_CRON ao wp-config.php: essa constante desliga o acionamento automático por requisições comuns. Se o agendamento substituto não funcionar, tarefas podem ficar pendentes. Método de chamada, intervalo, regras de acesso e limites variam conforme a hospedagem; não copie comandos genéricos sem saber como o site está configurado.
Com apoio técnico, inventarie as rotinas críticas, faça backup e registre a configuração atual. Configure primeiro o agendamento suportado pelo provedor; confirme em logs e nos eventos que ele aciona o WordPress; teste publicações e tarefas de baixo risco. Só depois, se for apropriado, desative o gatilho por visitas e valide novamente. Deixe um plano para reverter a configuração caso falhe. Pagamentos, assinaturas e fretes exigem testes em sandbox ou janela controlada. Se o atraso é eventual e não traz impacto, mudar o cron pode não ser necessário.
Valide a correção sem afetar clientes
Em staging ou ambiente controlado, acompanhe um post de teste programado e compare horário planejado e publicação efetiva. Para backups, confirme a cópia recente e teste a restauração em ambiente isolado, sem sobrescrever a produção. Para emails, use destinatário autorizado e confira a entrega. Na loja, acompanhe logs e estados das ações; valide pagamento e frete somente em sandbox ou conforme procedimento aprovado. Observe por ciclos compatíveis com os intervalos reais das rotinas; WP-Cron padrão não garante execução no minuto exato.
Se o atraso persistir, reúna fuso do site, horários, nome do hook, alerta da Saúde do site, logs sem dados pessoais, mudanças recentes e informação sobre cron externo. Solicite ao suporte investigação de requisições internas, erros PHP, limites do ambiente e configuração do agendador. Não envie senhas, tokens, dados de clientes nem o conteúdo do wp-config.php.
Perguntas frequentes
Posso desativar WP-Cron para melhorar a performance?
Somente após configurar e confirmar outro agendador, testar rotinas essenciais e ter plano de reversão. Desligá-lo sem alternativa funcional pode interromper publicações e tarefas de plugins. Ganho de desempenho não é automático.
A URL wp-cron.php precisa exibir uma mensagem?
Não. Resposta vazia ou código HTTP isolado não comprova sucesso de uma tarefa. Compare horários, estados e logs da rotina específica.
O WP Crontrol mostra todas as ações do WooCommerce?
O WP Crontrol inspeciona eventos cron e informa compatibilidade com Action Scheduler, mas para conferir estados e logs das ações consulte também a tela WooCommerce > Status > Scheduled Actions, se disponível na instalação. Uma visão não substitui a outra.
