Web e Desenvolvimento

WordPress Cron Não Está Funcionando? Como Corrigir Tarefas Agendadas e Publicações Perdidas

WordPress Cron Not Working? How to Fix Scheduled Tasks and Missed Posts

Postagens agendadas do WordPress não estão sendo publicadas? Aprenda a diagnosticar problemas do WP-Cron, inspecionar eventos agendados, corrigir erros de loopback e configurar um trabalho cron de servidor confiável passo a passo.

WordPress Cron Não Funciona? Como Corrigir Tarefas Agendadas e Publicações Perdidas

Você agenda um artigo no WordPress para as 9:00 da manhã. Às 9:30, ele ainda não apareceu.

Ou talvez os e-mails do seu WooCommerce cheguem atrasados, os backups agendados nunca comecem, ou um plugin informe que suas tarefas em segundo plano estão atrasadas.

Esses problemas frequentemente têm algo em comum: WP-Cron, o sistema de agendamento de tarefas integrado do WordPress.

O WP-Cron é conveniente porque funciona sem exigir acesso ao agendador de tarefas do seu servidor de hospedagem. Mas, diferentemente de uma tarefa cron tradicional do sistema, ele não é executado continuamente em segundo plano.

Neste guia, você aprenderá como o WP-Cron funciona, como identificar a causa de tarefas atrasadas e como substituir seu mecanismo de disparo padrão por uma tarefa cron de servidor confiável quando necessário.

Vamos abordar tanto hospedagem compartilhada quanto servidores com acesso à linha de comando.

1. Como o WP-Cron realmente funciona

Um daemon cron tradicional do Linux verifica sua programação independentemente do tráfego do site.

O WP-Cron funciona de maneira diferente. O WordPress verifica se há tarefas agendadas durante a atividade normal do site e, quando apropriado, tenta iniciar uma requisição para wp-cron.php.

Isso significa que um evento agendado não tem garantia de execução no horário exato previsto.

Imagine um site que recebe seu último visitante às 10:00 da noite. Um backup está agendado para as 2:00 da manhã, mas ninguém visita o site durante a noite.

O backup pode não começar até que o WordPress receba outra requisição que acione seu sistema de agendamento.

Como os dois métodos de agendamento diferem

WP-Cron padrão: Requisição do visitante → WordPress verifica eventos → Tarefas vencidas começam. Depende das requisições do WordPress.

Cron do servidor: Agendador do servidor → Executa a cada cinco minutos → Tarefas vencidas começam. Opera independentemente do tráfego de visitantes.

Uma tarefa cron do servidor não altera a maneira como o WordPress armazena os eventos agendados. Ela simplesmente fornece uma forma mais previsível de verificar e executá-los.

2. Reconheça os sintomas antes de mudar qualquer coisa

Nem toda operação atrasada do WordPress é causada pelo WP-Cron.

Comece identificando o sintoma real.

Sintoma Explicação possível
Publicações agendadas mostram "Agendamento perdido" Disparo do cron atrasado ou que falhou
E-mails agendados chegam atrasados Atraso do cron, processamento da fila ou problema de entrega de e-mail
Backups automáticos nunca começam Evento ausente, falha do cron ou erro do plugin de backup
Ações do WooCommerce permanecem pendentes Problema de processamento do Action Scheduler
O Diagnóstico do Site relata um erro de loopback O WordPress não consegue requisitar sua própria URL de forma confiável
Tarefas são executadas apenas após visitar o site Disparo do cron dependente de tráfego

A distinção importante está entre uma tarefa que nunca começa e uma tarefa que começa mas falha.

Substituir o WP-Cron por um agendador de servidor pode resolver o primeiro problema. Isso não reparará automaticamente um plugin com defeito, um banco de dados indisponível ou um serviço de e-mail que está falhando.

3. Verifique o Diagnóstico do Site do WordPress primeiro

Antes de mexer nos arquivos de configuração, abra a interface de administração do WordPress.

  1. Vá em Ferramentas → Diagnóstico do Site.
  2. Abra a aba Status.
  3. Procure por avisos relacionados a eventos agendados ou requisições de loopback.
  4. Registre a mensagem exata antes de fazer alterações.

Uma requisição de loopback é uma requisição que o WordPress faz ao seu próprio site.

Se essas requisições falham, as tarefas agendadas podem não ser acionadas corretamente.

Causas comuns incluem uma URL do site incorreta, problemas de resolução de DNS, problemas com certificados SSL, autenticação HTTP, restrições de firewall ou conflitos com plugins e temas.

Exemplo: um site de staging protegido por senha

Suponha que você tenha criado um ambiente de staging do WordPress em:

https://staging.example.com

O site de staging exige autenticação básica HTTP (HTTP Basic Authentication).

O WordPress tenta requisitar seu próprio endpoint wp-cron.php, mas o servidor retorna HTTP 401 porque a requisição não está autenticada.

O problema não é necessariamente a tarefa agendada em si. A requisição que deveria acionar a tarefa está sendo rejeitada.

Nessa situação, você pode usar um agendador CLI do lado do servidor, que evita a rota pública de loopback HTTP, ou configurar o ambiente para que as requisições internas do WordPress funcionem corretamente.

Não remova a proteção por senha de um site de staging simplesmente para fazer o cron funcionar.

4. Inspecione tarefas agendadas com WP-CLI

Se você tem acesso SSH e o WP-CLI instalado, pode inspecionar o agendador diretamente.

Primeiro, entre no diretório da sua instalação do WordPress.

cd /path/to/wordpress

Depois, liste os eventos agendados:

wp cron event list

Você verá informações como o nome do hook, a próxima execução agendada e a recorrência.

Para uma saída legível por máquina:

wp cron event list --fields=hook,next_run_gmt,recurrence --format=json

O que você deve procurar?

Preste atenção em eventos cuja próxima execução esteja no passado.

Um evento atrasado é um sinal de alerta útil, mas um único evento atrasado por si só não prova que todo o agendador está com defeito.

Verifique se vários hooks não relacionados estão atrasados. Se estiverem, investigue o mecanismo de disparo global.

Illustration of the article's main concept

Se apenas os eventos de um plugin estiverem afetados, inspecione esse plugin primeiro.

Executar tarefas vencidas manualmente

Em um ambiente de staging, ou após confirmar as consequências em produção, execute:

wp cron event run --due-now

Isso pede ao WordPress que execute os eventos que estão atualmente vencidos.

Tenha cuidado: este comando realiza trabalho real. Ele pode publicar conteúdo agendado, enviar mensagens, iniciar backups ou acionar operações de e-commerce.

Não é uma prévia de diagnóstico inofensiva.

Se ele for concluído com sucesso, mas as tarefas se tornarem atrasadas novamente depois, seu problema pode ser o mecanismo de disparo automático, e não os callbacks das tarefas.

5. Substitua o WP-Cron dependente de tráfego por uma tarefa cron do servidor

Para um site de produção onde tarefas agendadas importam, uma tarefa cron do servidor costuma ser uma escolha melhor.

O objetivo é direto:

  • Impedir que o WordPress tente iniciar o WP-Cron automaticamente em requisições normais de página.
  • Pedir ao servidor que processe os eventos vencidos em intervalos regulares.

Passo 1: edite o wp-config.php

Faça um backup do wp-config.php.

Adicione esta configuração antes da linha que informa para você parar de editar:

define('DISABLE_WP_CRON', true);

Isso desativa a geração automática padrão do cron do WordPress. Isso não exclui os eventos agendados armazenados pelo WordPress.

Passo 2: crie uma tarefa agendada no seu servidor de hospedagem

Abra o painel de controle da sua hospedagem e encontre seu agendador de tarefas cron.

Para uma instalação padrão do WordPress, você pode agendar um comando PHP CLI semelhante a:

/usr/bin/php /home/account/public_html/wp-cron.php

Substitua tanto o caminho do executável PHP quanto o caminho da instalação do WordPress pelos valores reais fornecidos pela sua hospedagem.

O comando deve executar a versão correta do PHP e ter permissão para ler os arquivos do WordPress.

Se o WP-CLI estiver instalado, outra opção é:

cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now

Essa alternativa processa explicitamente os eventos vencidos do WordPress por meio do WP-CLI.

Use um método de agendamento para uma determinada instalação, em vez de configurar várias tarefas cron independentes para fazer a mesma coisa.

Passo 3: escolha um intervalo adequado

Para um site típico, cinco minutos é um bom ponto de partida.

Intervalo de execução Invocações do agendador por dia Atraso máximo de polling* Exemplo de expressão crontab
1 minuto 1.440 1 minuto * * * * *
5 minutos 288 5 minutos */5 * * * *
10 minutos 144 10 minutos */10 * * * *
15 minutos 96 15 minutos */15 * * * *
30 minutos 48 30 minutos */30 * * * *

*Pressupõe um agendador funcionando e tarefas de curta duração. A execução real pode ser atrasada pela carga do servidor ou por callbacks de longa duração.

Por exemplo, a cada cinco minutos:

*/5 * * * *

Um intervalo de um minuto oferece verificações mais frequentes, mas não é necessário para todo site.

Para um blog de baixo tráfego, cinco ou dez minutos podem ser inteiramente suficientes. Para uma loja de e-commerce movimentada, você pode precisar de um processamento mais frequente, dependendo da sua carga de trabalho em segundo plano.

Passo 4: teste o resultado

Depois de configurar a tarefa do servidor, aguarde pelo menos dois intervalos agendados.

Em seguida, inspecione a lista de eventos novamente:

wp cron event list

Confirme que os eventos anteriormente atrasados foram processados.

Verifique também os logs de cron da hospedagem.

Você também deve verificar uma operação de negócio real: uma publicação de teste agendada, uma tarefa de manutenção inofensiva, ou outra operação cujo resultado possa ser observado com segurança.

6. E se sua hospedagem não fornecer acesso SSH?

Você ainda pode configurar uma tarefa cron do servidor em muitos planos de hospedagem compartilhada.

Alguns painéis de hospedagem suportam uma requisição de URL agendada, por exemplo:

https://example.com/wp-cron.php

Outros oferecem execução de comandos PHP sem fornecer um terminal SSH interativo.

Prefira uma tarefa PHP CLI quando houver suporte. Uma requisição HTTP agendada pode ser afetada por redirecionamentos, restrições de acesso, regras de segurança ou problemas de rede.

Se o painel da sua hospedagem suportar apenas requisições HTTP, confirme que o endpoint está acessível e que a requisição está de fato acionando as tarefas vencidas.

Não presuma que receber uma resposta HTTP 200 prova que todo callback agendado foi concluído com sucesso.

Technical workflow illustration

7. Crie um evento de teste seguro

Para desenvolvedores, um pequeno plugin de teste pode ajudar a confirmar que o sistema de agendamento funciona independentemente dos plugins existentes.

Crie este arquivo:

wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php

Adicione:

<?php
/**
 * Plugin Name: CeiKay Cron Test
 * Description: Temporary diagnostic cron event.
 */

if (!defined('ABSPATH')) {
    exit;
}

add_action('ceikay_cron_test', function () {
    error_log(
        'CeiKay cron test executed at ' .
        gmdate('Y-m-d H:i:s') .
        ' UTC'
    );
});

register_activation_hook(__FILE__, function () {
    if (!wp_next_scheduled('ceikay_cron_test')) {
        wp_schedule_event(
            time() + 60,
            'hourly',
            'ceikay_cron_test'
        );
    }
});

register_deactivation_hook(__FILE__, function () {
    wp_clear_scheduled_hook('ceikay_cron_test');
});

Ative o plugin pela interface de administração do WordPress.

Ele registra um evento de hora em hora que grava uma mensagem de diagnóstico simples no log de erros do PHP. Ele não envia e-mails, não altera conteúdo nem faz requisições de rede externas.

O primeiro evento é agendado aproximadamente um minuto após a ativação.

Para testá-lo imediatamente após a ativação com WP-CLI:

wp cron event run ceikay_cron_test

Verifique o log de erros do PHP em busca de uma mensagem semelhante a:

CeiKay cron test executed at 2026-11-18 07:30:00 UTC

O timestamp é apenas um exemplo.

Se você preferir testar o agendador automático em vez de executar o hook manualmente, aguarde o evento se tornar vencido e permita que o mecanismo de cron configurado o processe.

Quando os testes estiverem concluídos, desative e exclua o plugin de diagnóstico.

8. Solução de problemas: a tarefa cron é executada, mas as tarefas ainda falham

Um disparo de cron funcional é apenas uma parte do sistema.

Se o agendador do seu servidor é executado com sucesso, mas as operações do WordPress continuam a falhar, use a tabela de diagnóstico a seguir.

Problema O que verificar Ação sugerida
Nenhum evento agendado listado O plugin pode não ter registrado seu hook Verifique a ativação do plugin e o código de agendamento
Eventos permanecem atrasados A tarefa do servidor pode não estar sendo executada Verifique os logs de cron, o caminho do PHP e as permissões
Erro fatal do PHP Falha no callback da tarefa ou no plugin Inspecione os logs de erros do PHP e o stack trace
HTTP 401 ou 403 Autenticação ou firewall Revise as restrições de acesso de loopback
HTTP 500 Falha da aplicação ou do servidor Inspecione os logs do PHP/servidor
Eventos são executados, mas os e-mails não chegam Problema no transporte de e-mail Verifique o SMTP ou os logs de entrega de e-mail
Execuções duplicadas Agendamentos duplicados ou processos sobrepostos Inspecione hooks, argumentos e bloqueios (locking)
Ações do WooCommerce permanecem pendentes Acúmulo no Action Scheduler Inspecione a interface de ações agendadas e as falhas individuais

Não exclua eventos atrasados cegamente

Pode ser tentador remover todo evento que pareça travado.

Evite fazer isso.

Um evento pode representar uma operação legítima de processamento relacionada a pagamentos agendados, uma tarefa de processamento de pedidos, uma entrega de e-mail ou um backup.

Excluir o evento pode remover o trabalho agendado sem corrigir o problema subjacente.

O WP-CLI fornece comandos para excluir eventos, mas estes devem ser usados apenas depois de identificar o hook e compreender seu propósito.

9. Evite eventos agendados duplicados nos seus próprios plugins

Se você está desenvolvendo um plugin do WordPress, um erro comum é registrar o mesmo evento recorrente repetidamente.

Por exemplo, agendar uma tarefa em cada carregamento de página sem verificar se ela já existe.

A abordagem correta é verificar primeiro:

if (!wp_next_scheduled('myplugin_daily_cleanup')) {
    wp_schedule_event(
        time() + HOUR_IN_SECONDS,
        'daily',
        'myplugin_daily_cleanup'
    );
}

Depois, registre o callback separadamente:

add_action('myplugin_daily_cleanup', function () {
    // Perform a small, bounded maintenance task.
});

Se o evento aceitar argumentos, use argumentos consistentes ao agendar, verificar e limpar o evento. O WordPress usa o hook e os argumentos para distinguir eventos agendados.

Considere também a duração da execução. Uma tarefa que processa milhares de registros em uma única requisição pode esgotar o tempo de execução ou a memória do PHP.

Para grandes cargas de trabalho, processe os dados em pequenos lotes, torne as operações seguras para nova tentativa e registre o progresso.

10. Uma checklist prática para um agendador WordPress confiável

Antes de considerar o problema resolvido, verifique estes pontos:

  • [ ] O Diagnóstico do Site do WordPress não mostra erros inexplicáveis de agendamento ou de loopback.
  • [ ] Os hooks agendados esperados existem.
  • [ ] O cron do servidor é executado no intervalo pretendido.
  • [ ] DISABLE_WP_CRON está configurado apenas depois que um disparo alternativo está pronto.
  • [ ] A tarefa cron usa o executável PHP correto e o caminho do WordPress.
  • [ ] Uma tarefa agendada real é concluída com sucesso.
  • [ ] Os logs podem ser consultados quando uma tarefa falha.
  • [ ] Nenhuma configuração de agendador duplicada está ativa.
  • [ ] Operações críticas têm seu próprio monitoramento ou alertas de falha.

Um agendador confiável não é apenas um que funciona. É aquele cujas falhas você consegue identificar e investigar.

11. Considerações finais: quando você deve usar o cron do servidor?

Para um pequeno blog pessoal com visitantes ocasionais e sem automações sensíveis ao tempo, o WP-Cron padrão pode ser perfeitamente adequado.

Mas se o seu site depende de publicação agendada, manutenção em segundo plano, processamento de e-commerce ou outras operações recorrentes, vale a pena considerar uma tarefa cron do servidor.

A melhoria não está em o cron do servidor tornar magicamente todo plugin do WordPress confiável. Ele remove uma fonte importante de incerteza: a dependência de requisições recebidas no site para acionar eventos vencidos.

Comece diagnosticando a falha real, inspecione os eventos agendados e só então mude o mecanismo de disparo.

Essa abordagem é mais segura do que instalar outro plugin ou modificar configurações sem saber o que deu errado.