Como corrigir o WP-Cron que não executa no WordPress
O que é o WP-Cron que não executa?
O WP-Cron é o agendador interno do WordPress que executa tarefas como publicar posts agendados, enviar e-mails, rodar backups e checar atualizações. Diferente de um cron real do sistema operacional, ele só dispara quando alguém acessa o site: cada visita verifica se há tarefas pendentes. Em sites com pouco tráfego, ou quando a chamada loopback ao wp-cron.php está bloqueada, as tarefas atrasam ou nunca rodam, e aparece o aviso de agendamento perdido.
Como identificar
- Um post agendado fica com o status “Agendamento perdido” (Missed schedule) e não é publicado na hora marcada.
- Em Ferramentas, Saúde do site, aparece o aviso “O WP-Cron não funcionou desde a última verificação”.
- Backups, e-mails transacionais e relatórios de plugins param de ser enviados sem nenhuma mensagem de erro.
- O comando wp cron event list via WP-CLI mostra eventos com a coluna de próxima execução muito atrasada.
Como prevenir
- Configure um cron real do servidor a cada 5 minutos desde a instalação, em vez de confiar no disparo por visita
- Monitore os eventos agendados com WP Crontrol ou WP-CLI e cheque a tela de Saúde do site após cada migração
- Garanta que firewall e Cloudflare nunca bloqueiem a requisição loopback ao wp-cron.php do próprio servidor
Causa
- O site tem pouco ou nenhum tráfego, então não há visitas para disparar o WP-Cron, que só roda quando uma página é carregada.
- A constante DISABLE_WP_CRON está definida como true no wp-config.php, mas nenhum cron real do servidor foi configurado para substituí-la.
- A requisição loopback (o site chamando o próprio wp-cron.php) está bloqueada por firewall, Cloudflare, autenticação HTTP básica ou DNS interno incorreto.
- Um plugin de cache de página inteira serve a home cacheada e o WordPress nunca executa o disparo do cron naquela visita.
- A constante ALTERNATE_WP_CRON foi ativada de forma incorreta e gera um redirecionamento que impede o agendador de concluir.
Como resolver
- Confirme se o cron está travado: instale o plugin WP Crontrol ou rode o comando de listagem do WP-CLI. Se houver eventos com horário no passado acumulados, o agendador não está disparando.
wp cron event list wp cron event run --due-now - Desative o WP-Cron interno: no wp-config.php, acima da linha que pede para parar de editar, adicione a constante que desliga o disparo por visita. Sozinha ela para o agendador; o passo seguinte é obrigatório.
define( 'DISABLE_WP_CRON', true ); - Agende um cron real no servidor: no painel da hospedagem (cPanel, Cron Jobs) ou via crontab, crie uma tarefa que chame o wp-cron.php a cada 5 minutos. Use a versão por linha de comando para não depender de HTTP.
*/5 * * * * cd /home/usuário/public_html && php wp-cron.php >/dev/null 2>&1 - Teste a chamada loopback: abra o endereço seudominio.com/wp-cron.php?doing_wp_cron no navegador. Se a página carregar em branco e retornar 200, o loopback está livre; se travar ou der 403, há um bloqueio de firewall ou autenticação.
- Libere o loopback no firewall: se a chamada falhar, libere o IP do próprio servidor no firewall ou na regra de Cloudflare e remova qualquer autenticação HTTP básica que cubra o wp-cron.php.
// functions.php do tema filho — alerta se um evento do WP-Cron atrasa mais de 1 hora
add_action( 'admin_notices', function () {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
$proximo = wp_next_scheduled( 'wp_version_check' );
if ( $proximo && ( time() - $proximo ) > HOUR_IN_SECONDS ) {
$atraso = human_time_diff( $proximo, time() );
echo '<div class="notice notice-warning"><p>WP-Cron atrasado em ' . esc_html( $atraso ) . '. Verifique o cron do servidor.</p></div>';
}
} );Perguntas frequentes
Por que o WP-Cron não dispara sozinho?
Qual a diferença entre WP-Cron e um cron real do servidor?
Como saber se meu WP-Cron está travado?
Posts agendados pararam de publicar. É problema de cron?
Desativar o WP-Cron deixa o site mais rápido?
O que é a requisição loopback do WP-Cron?
Como corrigir o layout quebrado no mobile do WPForms no WordPress
O layout quebrado no mobile do WPForms acontece quando as colunas do formulário não empilham em coluna única no celular, geralmente porque a configuração Include Form Styling esta reduzida, falta a classe wpforms-mobile-full nos campos ou o CSS do tema sobrescreve os estilos do plugin.
Como corrigir certificados que não geram PDF no Tutor LMS
O certificado que não gera PDF no Tutor LMS acontece, na maioria das vezes, porque a extensão PHP Imagick esta ausente no servidor, o addon de Certificado não foi ativado, nenhum template foi atribuido ao curso ou a imagem de fundo esta fora das dimensoes exigidas.
Erro de enrollment no Tutor LMS: aluno não consegue comprar o curso
O erro de enrollment no Tutor LMS acontece quando o aluno tenta comprar um curso pago e a matrícula não é concluída: o botão de compra não aparece ou o pagamento passa mas o acesso nunca é liberado. Costuma vir do produto WooCommerce não vinculado ao curso, do curso marcado como Gratuito ou do pedido que não chega a Concluído.
Como corrigir o mapeamento de campos no User Registration do WPForms
O mapeamento de campos no User Registration do WPForms falha quando os dropdowns em Settings -> User Registration não apontam para os campos certos do formulário, quando o campo Email obrigatório esta ausente ou quando a Meta Key de um custom user meta não casa com o nome real do campo, fazendo os dados não chegarem ao perfil do usuário.
Como corrigir o erro de upload de arquivos no WPForms
O upload de arquivos no WPForms falha quando a extensão esta fora da lista permitida do campo, o arquivo passa do limite do servidor (upload_max_filesize) ou um plugin de cache serve uma versão antiga do formulário. A correção trata cada uma dessas três frentes.
Como corrigir a integração com Zoom nas aulas ao vivo do Tutor LMS no WordPress
A integração do Tutor LMS com o Zoom falha quando as credenciais ainda são do antigo app JWT (descontinuado), quando o app Server-to-Server OAuth está sem os escopos de Meeting, ou quando o addon Zoom Integration do Tutor LMS Pro não está ativo. A reunião não é criada e o botão da aula ao vivo não aparece.
