Anomalia: Ordini WooCommerce Salvati in Email ma Assenti nel Pannello di Amministrazione

Il fenomeno per cui le notifiche di nuovi ordini su WooCommerce vengono regolarmente recapitate via email, ma gli ordini corrispondenti risultano assenti o non visualizzabili nel pannello di amministrazione sotto la sezione “WooCommerce > Ordini”, rappresenta una grave anomalia che compromette la gestione operativa dell’e-commerce. L’arrivo della notifica email attesta che il processo di pagamento è stato completato e che, in una fase iniziale, WooCommerce ha riconosciuto la transazione. Tuttavia, la successiva mancata registrazione dell’oggetto Order nel database indica un fallimento critico nella fase di commit dei dati o un’interferenza che blocca la creazione del post type personalizzato shop_order.

Le cause di questa discrepanza sono tipicamente riconducibili a tre macro-aree di investigazione, da affrontare con un approccio metodico di debugging:

1. Conflitti di Plugin e Temi (Causa più Frequente)

Il malfunzionamento può derivare da un conflitto tra WooCommerce e un altro componente software installato, in particolare un plugin che interagisce con il checkout, la gestione degli ordini, il database o i gateway di pagamento.

• Gateway di Pagamento Specifici: Se il problema si manifesta solo con specifici metodi di pagamento (es. Stripe, PayPal avanzato, ecc.), è probabile che l’integrazione di quel gateway non stia gestendo correttamente il callback o la logica di salvataggio dell’ordine (funzione woocommerce_thankyou). Se il gateway non fornisce a WooCommerce l’esito finale della transazione con lo stato corretto, l’ordine potrebbe non essere mai creato nel database pur avendo generato l’email di conferma.
• Debug per Isolamento: Per isolare il colpevole, è imperativo eseguire un test di troubleshooting in un ambiente di staging. Si procede disattivando tutti i plugin ad eccezione di WooCommerce e del gateway di pagamento in uso. Se in queste condizioni l’ordine viene salvato correttamente, la riattivazione sequenziale dei plugin identificherà quello che causa il conflitto.

2. Problemi di Database e Server-Side (Causa Fondamentale)

Se la notifica email viene inviata ma l’ordine non è salvato, ciò suggerisce che la funzione principale di scrittura nel database (query INSERT) è stata interrotta.

• Saturazione o Corruzione del Database: Se le tabelle del database di WordPress, in particolare quelle relative ai post types e ai metadati (come wp_posts e wp_postmeta), sono corrotte o raggiungono limiti di spazio (situazione remota su hosting moderni ma possibile), la scrittura di un nuovo record di tipo shop_order fallisce. Una verifica tramite strumenti come phpMyAdmin o plugin di manutenzione del database può essere necessaria.
• Limiti di Memoria PHP e Timeout: L’esecuzione dello script PHP di WooCommerce al momento del checkout può superare i limiti di memory_limit o max_execution_time imposti dal server, causando un’interruzione prima che l’ordine venga salvato, pur avendo il tempo di innescare l’invio dell’email. L’aumento di questi parametri nel file wp-config.php o nel php.ini del server è una soluzione tecnica cruciale.

3. Anomalie di Stato dell’Ordine e Transitori

WooCommerce registra un ordine nel database solo se questo raggiunge uno stato valido e riconosciuto (es. pending, processing, completed).

• Cache e Transitori: Dati transient o di caching obsoleti possono interferire. È fondamentale svuotare la cache di WooCommerce (Strumenti > Transitori WooCommerce) e quella lato server/plugin di caching (es. WP Rocket, Varnish).
• Verifica dello Stato:* Se gli ordini vengono salvati ma con uno stato non visualizzato, potrebbe esserci un filtro anomalo. Se l’email viene inviata, l’ordine esiste a livello transazionale, ma la sua visualizzazione può essere soppressa.

Azione Correttiva di Debug Consigliata: Abilitare la modalità di debug di WordPress in wp-config.php (define('WP_DEBUG', true); e define('WP_DEBUG_LOG', true);) e replicare l’ordine per catturare eventuali errori PHP che potrebbero indicare esattamente quale linea di codice o quale plugin sta generando l’interruzione. La risoluzione dell’anomalia richiede l’identificazione e la rimozione definitiva del fattore di blocco che impedisce il salvataggio persistente del record d’ordine.