Action Scheduler di WooCommerce bloccato: diagnosticare code e operazioni fallite
- Wordpress
- 4 settembre 2026
Indice dei contenuti
Ordini, webhook, rinnovi, notifiche e sincronizzazioni WooCommerce possono essere elaborati in background. Quando la coda si blocca, il checkout può continuare ad accettare ordini mentre alcune operazioni successive restano in attesa o falliscono. È una situazione insidiosa perché il problema non sempre produce un errore immediatamente visibile nel negozio.
Action Scheduler è la libreria utilizzata da WooCommerce e da numerose estensioni per gestire attività pianificate. Una coda con azioni “pending”, “failed” o “past-due” non va svuotata indiscriminatamente: bisogna identificare quale hook è coinvolto, quale componente lo ha creato e se rilanciarlo può duplicare un’operazione.
A cosa serve Action Scheduler in WooCommerce
Action Scheduler organizza processi che non devono necessariamente completarsi durante la richiesta dell’utente. La documentazione WooCommerce sulle automazioni cita attività in background collegate, fra l’altro, a notifiche degli ordini e pagamenti.
Le estensioni possono usarlo per scopi differenti:
- consegnare webhook a software esterni;
- elaborare rinnovi e scadenze;
- inviare email in coda;
- aggiornare indici o dati analitici;
- eseguire importazioni e sincronizzazioni;
- completare migrazioni interne di dati;
- suddividere lavori lunghi in azioni più piccole.
Per questo non esiste una correzione unica per “Action Scheduler bloccato”. La stessa schermata può contenere attività di più plugin, con conseguenze e requisiti diversi.
Come leggere azioni pending, failed e past-due
Un’azione pending è in attesa della propria esecuzione. Se la data prevista è trascorsa da poco, non dimostra necessariamente un problema: l’elaborazione può dipendere dalla frequenza del runner e dal carico corrente. Molte azioni scadute da tempo, invece, indicano che la coda non viene smaltita o che continua a crescere più velocemente di quanto venga processata.
Un’azione failed è stata avviata senza completarsi correttamente. La causa può essere registrata nel log dell’azione oppure nei log PHP e WooCommerce. Un timeout, un errore fatale, dati mancanti o un servizio remoto non disponibile richiedono interventi differenti.
Prima di agire occorre annotare:
- nome esatto dell’hook;
- gruppo dell’azione;
- data programmata e numero di tentativi;
- argomenti associati, evitando di esporre dati sensibili;
- messaggio presente nel log;
- plugin o integrazione proprietaria del processo;
- andamento della coda nel tempo.
Perché la coda di WooCommerce rimane bloccata
Action Scheduler usa normalmente WP-Cron per avviare il runner. Se WP-Cron non opera correttamente, le azioni possono accumularsi. L’approfondimento su WP-Cron che non funziona in WordPress tratta questa dipendenza a livello di scheduler.
La coda può però bloccarsi anche con WP-Cron attivo. Fra le cause da verificare ci sono:
- task più lunghi del tempo concesso a PHP;
- errori fatali dentro un hook specifico;
- API esterna lenta, irraggiungibile o con credenziali scadute;
- query inefficienti durante ogni azione;
- risorse server insufficienti rispetto al volume;
- lock o processi concorrenti;
- versione incompatibile di un’estensione;
- crescita continua causata da un job che genera nuove azioni.
Una coda grande non è automaticamente guasta. Durante un’importazione o una migrazione può essere normale avere molte attività pendenti. Il dato utile è se il numero diminuisce, rimane stabile o continua a crescere senza completamenti.
Perché non conviene rilanciare tutte le azioni fallite
Il pulsante di esecuzione manuale è utile per un test mirato, ma non sostituisce la diagnosi. Un webhook potrebbe già essere arrivato al destinatario anche se la risposta non è stata registrata correttamente. Un rinnovo o un’email potrebbero avere effetti non idempotenti, cioè non sicuri da ripetere senza verifiche.
Prima di rilanciare bisogna capire se l’operazione:
- può essere eseguita più volte senza duplicare risultati;
- dipende ancora da dati validi;
- fallisce sempre nello stesso punto;
- richiede prima la correzione di configurazione o codice;
- coinvolge pagamenti, ordini o sistemi esterni.
Anche cancellare la coda può nascondere il sintomo senza ripristinare l’automazione. Le nuove azioni torneranno ad accumularsi se il runner o l’hook restano difettosi.
Diagnosi con log, WP-CLI e ambiente di test
Action Scheduler offre comandi WP-CLI per controllare ed eseguire la coda. La documentazione ufficiale del progetto indica che WP-CLI può essere più adatto del runner web per code grandi o task lunghi, perché non incontra gli stessi vincoli di una normale richiesta HTTP.
Questo non significa che il comando debba essere lanciato senza limiti in produzione. Batch, gruppi e hook vanno selezionati in base al problema e alle risorse disponibili. L’opzione che forza la concorrenza può aumentare il carico e deve essere usata solo dopo aver compreso le conseguenze.
Una procedura prudente consiste nel riprodurre un singolo hook, correlare orario e log, verificare database e chiamate esterne, quindi applicare una modifica controllata. Se il difetto dipende da un plugin, occorre anche verificare versione, changelog e compatibilità prima di intervenire sui suoi dati.
Quando configurare un runner via WP-CLI
Su negozi con code consistenti o processi business-critical può essere opportuno eseguire Action Scheduler da riga di comando attraverso il cron del server. Questo permette un’attivazione più prevedibile e un controllo esplicito dei batch.
La configurazione va però progettata. Se viene disabilitato il runner predefinito senza predisporre quello alternativo, nessuna azione sarà elaborata. Bisogna inoltre evitare runner sovrapposti, monitorare gli errori e dimensionare la frequenza sul volume reale.
In alcuni casi è sufficiente correggere WP-Cron. In altri occorre ottimizzare l’hook, ridurre le operazioni per batch, correggere una query o rendere più robusta l’integrazione remota. Il runner non può compensare indefinitamente un’attività che genera errori o impiega troppo tempo.
Quando serve assistenza tecnica per la coda WooCommerce
È opportuno intervenire quando azioni relative a ordini, pagamenti, rinnovi o integrazioni restano scadute; quando la coda cresce continuamente; oppure quando lo stesso hook fallisce dopo ogni tentativo.
Se il tuo ecommerce presenta azioni WooCommerce ferme o fallite, posso analizzare hook, log, WP-Cron, database e servizi collegati per stabilire se serva una correzione del runner, del plugin o dell’integrazione. Trovi maggiori informazioni nel servizio di assistenza per ecommerce esistenti.
