WordPress Cron non funziona? Come risolvere le attività programmate e i post mancanti
I post programmati di WordPress non vengono pubblicati? Impara a diagnosticare i problemi di WP-Cron, ispezionare gli eventi programmati, correggere gli errori di loopback e configurare un lavoro cron del server affidabile passo dopo passo.
WordPress Cron non funziona? Come correggere i task programmati e i post mancati
Programmi un articolo di WordPress per le 9:00 del mattino. Alle 9:30, ancora non è apparso.
O forse i tuoi email WooCommerce arrivano in ritardo, i backup programmati non partono mai, o un plugin segnala che i suoi task in background sono in ritardo.
Questi problemi spesso hanno qualcosa in comune: WP-Cron, il sistema di pianificazione dei task integrato di WordPress.
WP-Cron è comodo perché funziona senza richiedere l'accesso al task scheduler del tuo server di hosting. Ma a differenza di un cron job di sistema tradizionale, non continua a funzionare in background.
In questa guida, imparerai come funziona WP-Cron, come identificare la causa dei task ritardati e come sostituire il suo meccanismo di attivazione predefinito con un cron job di server affidabile quando necessario.
Copriremo sia lo hosting condiviso che i server con accesso da riga di comando.
1. Come funziona effettivamente WP-Cron
Un daemon cron Linux tradizionale controlla il suo programma indipendentemente dal traffico del sito.
WP-Cron funziona in modo diverso. WordPress controlla i task programmati durante l'attività normale del sito e, quando appropriato, tenta di avviare una richiesta a wp-cron.php.
Questo significa che un evento programmato non è garantito eseguire esattamente all'orario stabilito.
Imagina un sito che riceve l'ultimo visitatore alle 22:00. Un backup è programmato per le 2:00 del mattino, ma nessuno visita il sito durante la notte.
Il backup potrebbe non iniziare fino a quando WordPress non riceve un'altra richiesta che attiva il suo sistema di pianificazione.
Come differiscono i due metodi di pianificazione
WP-Cron predefinito: Richiesta visitatore → WordPress controlla eventi → I task iniziano. Dipende dalle richieste di WordPress.
Cron server: Scheduler del server → Esegui ogni cinque minuti → I task iniziano. Opera in modo indipendente dal traffico dei visitatori.
Un cron job di server non cambia il modo in cui WordPress memorizza gli eventi programmati. Fornisce semplicemente un modo più prevedibile per controllarli ed eseguirli.
2. Riconoscere i sintomi prima di cambiare qualsiasi cosa
Non ogni operazione ritardata di WordPress è causata da WP-Cron.
Inizia identificando il sintoma effettivo.
| Sintoma | Spiegazione possibile |
|---|---|
| I post programmati mostrano "Programmazione mancata" | Trigger cron ritardato o fallito |
| Email programmate arrivano in ritardo | Ritardo cron, elaborazione coda o problema di consegna email |
| Backup automatici non partono mai | Evento mancato, fallimento cron o errore plugin backup |
| Azioni WooCommerce rimangono in sospesa | Problema di elaborazione Action Scheduler |
| Site Health segnala un errore loopback | WordPress non può richiedere in modo affidabile il proprio URL |
| I task eseguono solo dopo aver visitato il sito | Attivazione cron dipendente dal traffico |
La distinzione importante è tra un task che non inizia mai e un task che inizia ma fallisce.
Sostituire WP-Cron con uno scheduler di server può risolvere il primo problema. Non riparerà automaticamente un plugin rotto, un database non disponibile o un servizio email fallito.
3. Controlla prima WordPress Site Health
Prima di toccare i file di configurazione, apri l'interfaccia di amministrazione di WordPress.
- Vai su Strumenti → Stato del sito.
- Apri la scheda Stato.
- Cerca avvisi relativi a eventi programmati o richieste loopback.
- Registra il messaggio esatto prima di effettuare modifiche.
Una richiesta loopback è una richiesta che WordPress fa al proprio sito.
Se queste richieste falliscono, i task programmati potrebbero non essere attivati correttamente.
Le cause comuni includono un URL del sito errato, problemi di risoluzione DNS, problemi con i certificati SSL, autenticazione HTTP, restrizioni del firewall o conflitti con plugin e temi.
Esempio: un sito di staging protetto da password
Supponi di aver creato un ambiente di staging di WordPress su: ```text https://staging.example.com
Il sito di staging richiede l'autenticazione HTTP Base.
WordPress tenta di richiedere il proprio endpoint `wp-cron.php`, ma il server restituisce HTTP 401 perché la richiesta non è autenticata.
Il problema non è necessariamente il task programmato stesso. La richiesta che dovrebbe attivare il task viene rifiutata.
In questa situazione, puoi utilizzare uno scheduler CLI lato server, che evita il percorso HTTP loopback pubblico, o configurare l'ambiente in modo che le richieste interne di WordPress funzionino correttamente.
Non rimuovere la protezione da password da un sito di staging solo per far funzionare cron.
## 4. Ispeziona i task programmati con WP-CLI
Se hai accesso SSH e WP-CLI installato, puoi ispezionare direttamente lo scheduler.
Prima, spostati nella directory di installazione di WordPress.
```bash
cd /path/to/wordpress
Quindi elenca gli eventi programmati:
wp cron event list
Vedrai informazioni come il nome dell'hook, la prossima esecuzione programmata e la ricorrenza.
Per un output leggibile da macchina:
wp cron event list --fields=hook,next_run_gmt,recurrence --format=json
Cosa dovresti cercare?
Presta attenzione agli eventi la cui prossima ora di esecuzione è nel passato.
Un evento in ritardo è un utile segnale di avvertimento, ma un solo evento in ritardo non dimostra che l'intero scheduler sia rotto.
Controlla se più hook non correlati sono in ritardo. Se lo sono, indaga il meccanismo di attivazione globale.

Se sono affetti gli eventi di un solo plugin, ispeziona prima quel plugin.
Esegui i task scaduti manualmente
Su un ambiente di staging, o dopo aver confermato le conseguenze in produzione, esegui:
wp cron event run --due-now
Questo chiede a WordPress di eseguire gli eventi attualmente scaduti.
Attenzione: questo comando esegue un lavoro reale. Potrebbe pubblicare contenuti programmati, inviare messaggi, avviare backup o attivare operazioni di e-commerce.
Non è una anteprima diagnostica innocua.
Se completato con successo ma i task diventano di nuovo in ritardo, il problema potrebbe essere il meccanismo di attivazione automatica piuttosto che i callback dei task.
5. Sostituisci WP-Cron dipendente dal traffico con un cron job di server
Per un sito di produzione dove i task programmati contano, un cron job di server è spesso una scelta migliore.
L'obiettivo è semplice:
- Fermare WordPress dal tentare di generare WP-Cron automaticamente sulle richieste di pagina normali.
- Chiedere al server di elaborare gli eventi scaduti a intervalli regolari.
Passo 1: modifica wp-config.php
Fai un backup di wp-config.php.
Aggiungi questa configurazione prima della riga che ti dice di smettere di modificare:
define('DISABLE_WP_CRON', true);
Questo disabilita la generazione automatica predefinita di WP-Cron. Non elimina gli eventi programmati memorizzati da WordPress.
Passo 2: crea un task programmat sul tuo server di hosting
Apri il pannello di controllo del tuo hosting e trova il suo scheduler di cron job.
Per un'installazione WordPress standard, puoi programmare un comando PHP CLI simile a:
/usr/bin/php /home/account/public_html/wp-cron.php
Sostituisci sia il percorso dell'eseguibile PHP che il percorso di installazione di WordPress con i valori effettivi forniti dal tuo host.
Il comando deve eseguire la versione corretta di PHP e avere i permessi per leggere i file di WordPress.
Se WP-CLI è installato, un'altra opzione è:
cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now
Questa alternativa elabora esplicitamente gli eventi WordPress scaduti attraverso WP-CLI.
Utilizza un solo metodo di pianificazione per una data installazione piuttosto che configurare più cron job indipendenti per fare la stessa cosa.
Passo 3: scegli un intervallo adatto
Per un sito tipico, cinque minuti è un punto di partenza ragionevole.
| Intervallo di esecuzione | Invocazioni scheduler al giorno | Ritardo massimo di polling* | Esempio di espressione crontab |
|---|---|---|---|
| 1 minuto | 1.440 | 1 minuto | * * * * * |
| 5 minuti | 288 | 5 minuti | */5 * * * * |
| 10 minuti | 144 | 10 minuti | */10 * * * * |
| 15 minuti | 96 | 15 minuti | */15 * * * * |
| 30 minuti | 48 | 30 minuti | */30 * * * * |
*Supone un scheduler funzionante e task a esecuzione breve. L'esecuzione effettiva può essere ritardata dal carico del server o da callback a lunga durata.
Ad esempio, ogni cinque minuti:
*/5 * * * *
Un intervallo di un minuto offre controlli più frequenti ma non è necessario per ogni sito.
Per un blog a basso traffico, cinque o dieci minuti possono essere del tutto sufficienti. Per un negozio e-commerce occupato, potresti aver bisogno di un'elaborazione più frequente a seconda del suo carico di lavoro in background.
Passo 4: testa il risultato
Dopo aver configurato il job del server, attendi almeno due intervalli programmati.
Quindi ispeziona di nuovo l'lista degli eventi:
wp cron event list
Conferma che gli eventi precedentemente in ritardo sono stati elaborati.
Controlla anche i log del cron dell'hosting.
Dovresti anche verificare un'operazione commerciale reale: un post di test programmato, un task di manutenza innocuo, o un'altra operazione il cui risultato può essere osservato in sicurezza.
6. E se il tuo host non fornisce l'accesso SSH?
Puoi comunque configurare un cron job di server su molti piani di hosting condivisi.
Alcuni pannelli di hosting supportano una richiesta URL programmata, per esempio:
https://example.com/wp-cron.php
Altri offrono l'esecuzione di comandi PHP senza fornire un terminale SSH interattivo.
Preferisci un task PHP quando supportato. Una richiesta HTTP programmata può essere influenzata da redirect, restrizioni di accesso, regole di sicurezza o problemi di rete.
Se il tuo pannello di hosting supporta solo richieste HTTP, conferma che l'endpoint è raggiungibile e che la richiesta sta effettivamente attivando i task scaduti.
Non supporre che ricevere una risposta HTTP 200 dimostra che ogni callback programmata si sia completata con successo.

7. Crea un evento di test sicuro
Per gli sviluppatori, un piccolo plugin di test può aiutare a confermare che il sistema di pianificazione funziona in modo indipendente dai plugin esistenti.
Crea questo file:
wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php
Aggiungi:
<?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');
});
Attiva il plugin dall'interfaccia di amministrazione di WordPress.
Registra un evento orario che scrive un semplice messaggio diagnostico nel log degli errori di PHP. Non invia email, altera contenuti o effettua richieste di rete esterne.
Il primo evento è programmato circa un minuto dopo l'attivazione.
Per testarlo immediatamente dopo l'attivazione con WP-CLI:
wp cron event run ceikay_cron_test
Controlla il log degli errori di PHP per un messaggio simile a:
CeiKay cron test executed at 2026-11-18 07:30:00 UTC
Il timestamp è solo un esempio.
Se preferisci testare lo scheduler automatico piuttosto che eseguire manualmente l'hook, attendi che l'evento scada e permetti al meccanismo cron configurato di elaborarlo.
Quando il test è completato, disattiva ed elimina il plugin diagnostico.
8. Risoluzione dei problemi: il cron job esegue, ma i task falliscono ancora
Un trigger cron funzionante è solo una parte del sistema.
Se il tuo scheduler del server esegue con successo ma le operazioni di WordPress continuano a fallire, usa la seguente tabella diagnostica.
| Problema | Cosa controllare | Azione suggerita |
|---|---|---|
| Nessun evento programmato elencato | Il plugin potrebbe non aver registrato il suo hook | Controlla l'attivazione del plugin e il codice di pianificazione |
| Gli eventi rimangono in ritardo | Il job del server potrebbe non essere in esecuzione | Controlla i log cron, percorso PHP e permessi |
| Errore PHP fatale | Fallimento del callback del task o del plugin | Ispeziona i log degli errori PHP e lo stack trace |
| HTTP 401 o 403 | Autenticazione o firewall | Revisiona le restrizioni di accesso loopback |
| HTTP 500 | Fallimento dell'applicazione o del server | Ispeziona i log PHP/server |
| Gli eventi eseguono ma le email non arrivano | Problema di trasporto mail | Controlla i log SMTP o di consegna email |
| Esecuzioni duplicate | Programmi duplicati o processi sovrapposti | Ispeziona hook, argomenti e locking |
| Le azioni WooCommerce rimangono in sospesa | Accumulo di Action Scheduler | Interfaccia delle azioni programmate e singoli fallimenti |
Non eliminare ciecamente gli eventi in ritardo
Potrebbe essere allettante rimuovere ogni evento che sembra bloccato.
Evita di farlo.
Un evento potrebbe rappresentare un'operazione di pagamento programmata legittima, un task di elaborazione ordini, consegna email o backup.
Eliminare l'evento può rimuovere il lavoro programmato senza risolvere il problema sottostante.
WP-CLI fornisce comandi per eliminare eventi, ma dovrebbero essere utilizzati solo dopo aver identificato l'hook e compreso lo scopo.
9. Evita eventi programmati duplicati nei tuoi plugin
Se stai sviluppando un plugin WordPress, un errore comune è registrare lo stesso evento ricorrente più volte.
Ad esempio, programmare un task su ogni caricamento di pagina senza controllare se esiste già.
L'approccio corretto è controllare prima:
if (!wp_next_scheduled('myplugin_daily_cleanup')) {
wp_schedule_event(
time() + HOUR_IN_SECONDS,
'daily',
'myplugin_daily_cleanup'
);
}
Quindi registra il callback separatamente:
add_action('myplugin_daily_cleanup', function () {
// Perform a small, bounded maintenance task.
});
Se l'accetta argomenti, usa argomenti coerenti quando programmi, controlli e cancelli. WordPress usa l'hook e gli argomenti per distinguere gli eventi programmati.
Considera anche la durata di esecuzione. Un task che elabora migliaia di record in una sola richiesta può esaurire il tempo di esecuzione di PHP o la memoria.
Per carichi di lavoro grandi, elabora i dati in piccoli lotti, rendi le operazioni sicure da riprovare e registra i progressi.
10. Una pratica checklist per uno scheduler WordPress affidabile
Prima di considerare il problema risolto, verifica questi punti:
- [ ] WordPress Site Health non mostra errori di pianificazione o loopback inspiegabili.
- [ ] Gli hook programmati attesi esistono.
- [ ] Il cron del server esegue all'intervallo previsto.
- [ ]
DISABLE_WP_CRONè configurato solo dopo che un trigger alternativo è pronto. - [ ] Il cron job usa il corretto eseguibile PHP e percorso di WordPress.
- [ ] Un task programmato reale si completa con successo.
- [ ] I log possono essere consultati quando un task fallisce.
- [ ] Nessuna configurazione scheduler duplicata è attiva.
- [ ] Le operazioni critiche hanno il proprio monitoraggio o avvisi di fallimento.
Uno scheduler affidabile non è solo uno che esegue. È uno i cui fallimenti puoi identificare e indagare.
11. Considerazioni finali: quando dovresti usare il cron del server?
Per un piccolo blog personale con visitatori occasionali e nessuna automazione sensibile all'ora, WP-Cron predefinito può essere perfettamente adeguato.
Ma se il tuo sito si basa su pubblicazione programmata, manutenzione in background, elaborazione e-commerce, o altre operazioni ricorrenti, un cron job di server vale la pena considerarlo.
Il miglioramento non è che il cron del server renda magico ogni plugin WordPress affidabile. Rimuove una importante fonte di incertezza: la dipendenza dalle richieste in entrata del sito per attivare gli eventi scaduti.
Inizia diagnosticando il fallimento effettivo, ispeziona gli eventi programmati e solo allora cambia il meccanismo di attivazione.
Questo approccio è più sicuro rispetto a installare un altro plugin o modificare le impostazioni di configurazione senza sapere cosa è andato storto.