Un problema di WooCommerce può presentarsi in molti modi diversi: il checkout non funziona, manca un metodo di pagamento, un ordine rimane nello stato sbagliato, un metodo di spedizione non compare o, dopo un aggiornamento, improvvisamente qualcosa funziona in modo diverso.
In situazioni del genere, di solito non è una buona idea modificare le impostazioni a caso o disattivare più plugin contemporaneamente. Anche se a volte questo permette di risolvere un problema per caso, continuerai a non conoscere la vera causa.
Un processo di ricerca guasti pulito segue invece un semplice principio:
Descrivere accuratamente il problema → riprodurlo → circoscrivere l'area interessata → controllare i log e lo stato del sistema → testare la causa in modo controllato → risolverlo solo dopo.
Importante: Durante la ricerca degli errori, cambia possibilmente sempre una sola cosa alla volta. Dopodiché prova di nuovo. Solo così puoi capire quale modifica ha effettivamente fatto la differenza.
Descrivi prima il problema vero e proprio #
„WooCommerce non funziona“ è molto troppo impreciso per la ricerca degli errori.
Cerca invece di annotare cosa sta succedendo esattamente.
Ad esempio:
„Se un cliente ordina con indirizzo di spedizione in Germania, al checkout non viene visualizzato alcun metodo di spedizione. Con un indirizzo svizzero, la spedizione funziona.“
Questa descrizione contiene già importanti indicazioni: il carrello funziona, il checkout viene caricato e il problema sembra essere legato alla spedizione e all'indirizzo del cliente.
Nota inoltre:
- Cosa volevi fare?
- Cosa ti aspettavi?
- Cos'è successo realmente?
- Puoi ripetere il problema?
- Si verifica con tutti i clienti o solo a determinate condizioni?
- Da quanto tempo esiste il problema?
- È stato modificato o aggiornato qualcosa immediatamente prima?
Più riesci a circoscrivere il problema, meno aree dovrai esaminare in seguito.
Prova a riprodurre il problema in modo controllato #
Un errore riproducibile è molto più semplice da studiare rispetto a un problema che si verifica „a volte in qualche modo“.
Apri quindi il tuo negozio possibilmente in una finestra di navigazione in incognito e ripeti esattamente la procedura in cui si verifica l'errore.
In caso di un problema di pagamento, ad esempio, ciò potrebbe significare:
- Aggiungere un determinato prodotto al carrello.
- Apri la cassa.
- Usa lo stesso indirizzo di spedizione.
- Selezionare lo stesso metodo di spedizione o pagamento.
- Effettuare nuovamente l'ordine oppure procedere fino al passaggio problematico.
Se l'errore si ripresenta, hai un caso di test riproducibile. Questo puoi ripeterlo dopo ogni modifica.
Durante un live-shopping: Non eseguire esperimenti rischiosi con dati di clienti reali o pagamenti di produzione. Per test approfonditi, un ambiente di staging o di test è decisamente più adatto.
Spiegheremo come eseguire una procedura di test completa nell'articolo Testare il negozio WooCommerce prima del lancio: ordine di prova e checklist.
Delimita l'area interessata #
WooCommerce è composto da molte aree che sono collegate tra loro. Ciononostante, in caso di un problema specifico, non è necessario esaminare l'intero negozio.
| Problema | Prima sezione per l'esame |
|---|---|
| Il prodotto non può essere acquistato | Stato del prodotto, prezzo, giacenza di magazzino e tipo di prodotto |
| Impossibile selezionare la variante | Attributi e varianti del prodotto |
| Metodo di spedizione mancante | Zona di spedizione, indirizzo del cliente e metodo di spedizione |
| Metodo di pagamento mancante | Impostazioni di pagamento e requisiti del fornitore di servizi di pagamento |
| Il pagamento non è riuscito | Note d'ordine e log dell'estensione di pagamento |
| L'ordine ha uno stato imprevisto | Metodo di pagamento, note dell'ordine e cronologia dello stato |
| E-mail di conferma ordine mancante | Impostazione e-mail e registro delle e-mail transazionali |
| L'attività in background non viene eseguita | Azioni pianificate e log |
| Pagina bianca o errore irreversibile | Fatal Error o registro degli errori PHP |
Questa limitazione impedisce, ad esempio, di modificare la configurazione di spedizione quando in realtà il pagamento non va buon fine.
Gli ordini e le note sugli ordini forniscono indicazioni importanti #
Se il problema è legato a un ordine specifico, dovresti prima consultarlo sotto WooCommerce → Ordini aprire.
Controlla lo stato dell'ordine, il metodo di pagamento utilizzato, il metodo di spedizione, i dati del cliente e le note dell'ordine.
WooCommerce e le estensioni possono inserire, ad esempio, informazioni su pagamenti, modifiche di stato o altre fasi di elaborazione nelle note degli ordini.
In caso di un problema di pagamento, si potrebbe notare, ad esempio, che un tentativo di pagamento è fallito. In questo caso, sarebbe errato impostare semplicemente l'ordine manualmente su „In lavorazione“, mascherando così il problema reale.
Ti spiegheremo come leggere e gestire correttamente gli ordini su Gestione degli ordini WooCommerce: stato, pagamento e spedizione.
Controlla lo stato del sistema WooCommerce #
Una delle fonti di informazione più importanti per la diagnosi tecnica si trova su:
WooCommerce → Stato
Lo stato del sistema mostra numerose informazioni sulla tua installazione di WordPress e WooCommerce. Queste includono, tra le altre:
- Versione di WordPress e WooCommerce
- Ambiente server e PHP
- Limite di memoria PHP
- Informazioni sul database
- plugin attivi e inattivi
- tema attivo e tema figlio
- Pagine WooCommerce
- Informazioni sui template di WooCommerce
- Action Scheduler
Il rapporto ti aiuta soprattutto a identificare anomalie e possibili problemi di compatibilità.
Importante: Non ogni valore nello stato del sistema è automaticamente un errore. Il rapporto fornisce informazioni tecniche e indicazioni. L'aspetto decisivo è sempre se un'anomalia corrisponde effettivamente al problema osservato.
Copia lo stato del sistema per il supporto #
WooCommerce consente di fornire lo stato del sistema come report per l'assistenza.
Sotto WooCommerce → Stato puoi aprire il rapporto di sistema e copiarlo o scaricarlo per una richiesta di supporto.
Questo è molto più utile che scrivere semplicemente:
„Il mio WooCommerce non funziona.“
Un addetto all'assistenza può ad esempio capire dal rapporto quali versioni di WooCommerce, WordPress e PHP vengono utilizzate, quali estensioni sono attive e quale tema è impiegato.
Usare correttamente i log di WooCommerce #
La seconda fonte di informazione centrale si trova presso:
WooCommerce → Stato → Registri
WooCommerce dispone di un proprio sistema di logging. WooCommerce stesso e molte estensioni possono registrare errori, avvisi ed eventi tecnici.
Quali log siano presenti dipende quindi dal tuo negozio e dalle estensioni installate.
Cerca il più possibile un log la cui data/ora e origine corrispondano al tuo problema.
Ad esempio, se un pagamento è fallito alle 14:32, un log corrispondente di quel momento è molto più interessante di un errore di tre settimane fa.
Un registro è un indizio, non automaticamente la causa. Ciò che conta è se il momento, la componente interessata e il messaggio di errore corrispondono al tuo problema riproducibile.
Prendere prima sul serio gli errori irreversibili #
WooCommerce registra automaticamente gli errori PHP gravi nei suoi log. Puoi trovare tali voci in WooCommerce → Stato → Registri in corrispondenza dei relativi record di errore irreversibile.
Un errore fatale significa che PHP ha dovuto interrompere l'elaborazione in corso a causa di un errore grave.
Un tale inserimento contiene solitamente dati tecnici come:
- Momento dell'errore
- Messaggio di errore
- file PHP interessato
- Numero di riga
- ulteriori informazioni tecniche sulla procedura
Per un non addetto ai lavori non ogni riga è comprensibile. Spesso tuttavia si può già dedurre dal percorso del file se l'errore proviene, ad esempio, da WooCommerce Core, da uno specifico plugin o dal tema.
Non modificare direttamente i file PHP: Se un errore fa riferimento a un file di un plugin, non dovresti semplicemente modificare il codice sorgente di quel file. Con un aggiornamento tali modifiche verrebbero sovrascritte e una modifica errata può causare ulteriori errori.
Registri dei log dei pagamenti e di altre estensioni #
Molte estensioni di WooCommerce dispongono di log di diagnostica aggiuntivi. Soprattutto nel caso dei provider di pagamento, questi sono spesso molto utili.
Tali registri devono prima essere attivati nelle relative impostazioni a seconda dell'estensione.
Se ad esempio un pagamento con carta di credito non va a buon fine, perciò non dovresti limitarti a controllare lo stato dell'ordine WooCommerce. Verifica anche le note dell'ordine e, se disponibile, il registro dell'estensione di pagamento effettivamente utilizzata.
La denominazione esatta e il contenuto di tali log differiscono da fornitore a fornitore.
Puoi trovare maggiori informazioni sull'interazione tra ordine e pagamento alla pagina Configurare e gestire i metodi di pagamento in WooCommerce.
Controllare le azioni pianificate #
WooCommerce e numerose estensioni non eseguono determinate attività immediatamente durante il caricamento di una pagina, ma le elaborano in background.
Per questo viene utilizzato, tra le altre cose, il Action Scheduler utilizzato.
La panoramica è disponibile all'indirizzo:
WooCommerce → Stato → Azioni programmate
Lì puoi vedere se i compiti, ad esempio:
- in attesa,
- completato,
- fallito
- o interrotto
sono.
Singole azioni non riuscite non significano automaticamente che l'intero negozio abbia un problema. Tuttavia, se molte attività si accumulano o la stessa azione fallisce ripetutamente, è opportuno indagarne la causa.
Gli errori irreversibili possono, ad esempio, impedire il completamento con successo di un'attività in background.
Verifica se il problema è iniziato dopo una modifica #
Il momento in cui si verifica un errore è spesso un ottimo indizio.
Chiediti:
Cosa è stato modificato immediatamente prima?
Questo potrebbe essere stato, ad esempio, un aggiornamento di WooCommerce, WordPress, di un plugin o di un tema. Forse è stata anche installata una nuova estensione, modificata un'impostazione o aggiunto del codice di programmazione personalizzato.
Se un negozio funziona per mesi e, immediatamente dopo una determinata modifica, si verifica un problema riproducibile, questa modifica è tra le prime cose che dovrebbero essere esaminate più da vicino.
Questo non dimostra ancora che ne sia la causa. Fornisce tuttavia un punto di partenza concreto.
Gli aggiornamenti fanno parte della diagnosi, ma in modo controllato #
Le versioni obsolete di WordPress, WooCommerce, plugin o temi possono causare errori e problemi di compatibilità. Le versioni aggiornate contengono inoltre correzioni di bug e aggiornamenti di sicurezza.
Ciò non significa tuttavia che tu debba aggiornare tutto a caso nel bel mezzo di una ricerca di errori in corso.
In un negozio in produzione è opportuno procedere in modo controllato:
- Documentare lo stato attuale e il problema.
- Assicurarsi che sia presente un backup recente.
- Se possibile, testare in un ambiente di staging.
- Eseguire gli aggiornamenti in modo controllato.
- Testare nuovamente l'errore precedentemente documentato.
Solo così puoi capire se l'aggiornamento ha effettivamente risolto il problema.
Testare i conflitti tra plugin in modo sistematico #
WooCommerce lavora spesso con molte estensioni contemporaneamente. Un errore può quindi essere causato da un conflitto tra due plugin.
Per un test di conflitto significativo, l'ambiente viene gradualmente ridotto.
In un ambiente di test sicuro, ad esempio, puoi disattivare tutti i plugin non necessari e lasciare attivi solo WooCommerce e l'estensione strettamente necessaria per il test specifico.
Testalo di nuovo dopo.
Se l'errore è scomparso, riattiva gli altri plugin in modo controllato e verifica nuovamente dopo ogni modifica. Non appena l'errore si ripresenta, avrai un forte indizio sul componente coinvolto.
Da non eseguire alla cieca nel live-shop: La disattivazione di plugin di pagamento, spedizione, sicurezza, cache o altri plugin importanti può alterare il normale funzionamento del negozio. Per questo motivo, i test approfonditi per la risoluzione dei conflitti dovrebbero essere eseguiti, se possibile, in un ambiente di staging.
Anche il tema può causare un conflitto #
Non solo i plugin possono influenzare WooCommerce. Anche il tema WordPress attivo contiene codice di programmazione e può, ad esempio, modificare le pagine dei prodotti, il carrello o il checkout.
Per questo motivo, durante un test completo dei conflitti, WooCommerce consiglia anche l'uso temporaneo di un tema di test standard noto come compatibile Vetrina.
Se il problema scompare con il tema di prova, mentre i plugin e le altre condizioni rimangono invariati, questo è un chiaro indizio del fatto che il tema precedente o le sue personalizzazioni sono coinvolti nel problema.
Anche questo test, se possibile, non dovrebbe essere eseguito in modo visibile per i normali visitatori di un negozio online attivo.
Il controllo dello stato di salute può facilitare i test di conflitto #
WordPress presenta con il plugin Controllo dello stato di salute e risoluzione dei problemi una speciale modalità di risoluzione dei problemi a disposizione.
Questa modalità consente a un amministratore effettuato l'accesso di modificare a titolo di prova plugin e tema per la propria sessione, senza che i normali visitatori vedano la stessa configurazione di test.
Ciò può essere utile in un test dei conflitti.
Rimane comunque prudente: Una modalità di risoluzione dei problemi non sostituisce un ambiente di staging completo. Soprattutto per pagamenti, interfacce esterne, processi in background e ordini reali, un ambiente di test separato è la soluzione più pulita.
La cache può falsare la ricerca degli errori #
La memorizzazione nella cache accelera i siti web, ma durante la risoluzione dei problemi può fare in modo che tu non veda immediatamente la versione aggiornata di una pagina.
Dopo le modifiche, a seconda del sistema di cache utilizzato, potrebbe pertanto essere necessario uno svuotamento mirato della cache in questione.
Anche il browser stesso può memorizzare file nella cache. Una finestra di navigazione in incognito del browser può quindi essere utile nei test di frontend.
Disattiva o elimina ma non disattivare o eliminare a puro titolo cautelativo tutte le impostazioni di performance. Verifica prima se la memorizzazione nella cache possa effettivamente essere correlata al problema specifico.
Distinguere tra errori di frontend e di server #
Non ogni problema di WooCommerce nasce sul server.
Ad esempio, se un pulsante non risponde, un'area di checkout non si aggiorna o gli elementi scompaiono improvvisamente, potrebbero essere coinvolti anche JavaScript o la visualizzazione nel browser.
Un PHP Fatal Error è invece un errore lato server.
Per una prima classificazione è quindi utile la domanda:
La pagina viene caricata completamente e non funziona solo una determinata operazione, oppure l'elaborazione si interrompe sistematicamente con un messaggio di errore?
Per diagnosi del browser più approfondite, gli strumenti di sviluppo del browser possono essere utili. Tuttavia, questi sono pensati piuttosto per utenti esperti o per il supporto tecnico.
Non ogni messaggio di errore proviene da WooCommerce #
Un negozio WooCommerce non è fatto solo di WooCommerce.
Core di WordPress, tema, plugin, provider di pagamento, interfacce esterne, PHP, database, server web e altri servizi lavorano insieme.
Un messaggio di errore nel checkout può quindi provenire, ad esempio, da un'estensione di pagamento, anche se viene visualizzato su una pagina WooCommerce.
Osserva quindi un messaggio di errore con la maggiore attenzione possibile:
Quale componente viene menzionato? Compare il nome di un plugin? C'è un codice di errore? Trovi una voce di log corrispondente nello stesso momento?
Queste informazioni sono solitamente più preziose della pagina in cui l'errore è diventato visibile.
Quando non dovresti continuare a provare da solo #
Una diagnosi sistematica non significa che tu debba riparare da solo ogni guasto tecnico.
Al più tardi in caso di gravi errori PHP, problemi al database, errori ricorrenti del server o problemi con i pagamenti in produzione, non dovresti apportare modifiche al codice sorgente o al database alla cieca.
Anche i messaggi di errore contenenti credenziali, chiavi API o altre informazioni sensibili non dovrebbero essere pubblicati pubblicamente.
Il tuo compito potrebbe consistere inizialmente nel circoscrivere chiaramente il problema e nel raccogliere le informazioni pertinenti per il supporto competente.
Cosa dovrebbe contenere una buona richiesta di supporto #
Più una richiesta tecnica è documentata, più velocemente è possibile solitamente esaminare un problema.
Una richiesta di supporto utile contiene:
- una descrizione dettagliata del problema,
- il comportamento atteso,
- il comportamento effettivamente osservato,
- i passaggi esatti con cui è possibile riprodurre l'errore,
- Momento o periodo di tempo dell'errore,
- messaggi di errore rilevanti,
- screenshot appropriati,
- voci di registro rilevanti,
- lo stato di sistema di WooCommerce,
- Informazioni sui test già effettuati.
Invece:
„Il pagamento non funziona.“
è, ad esempio, molto più utile la seguente informazione:
„Dall'aggiornamento del plugin X, dopo aver selezionato il metodo di pagamento Z per un ordine con il prodotto Y, viene visualizzato un messaggio di errore. L'errore può essere riprodotto in una finestra di navigazione in incognito. Nel registro di WooCommerce compare il seguente messaggio nello stesso momento...“
In questo modo il supporto sa già cosa è stato testato e dove può iniziare l'indagine.
Una semplice sequenza diagnostica per la vita di tutti i giorni #
Per il lavoro quotidiano non è necessario ricordare ogni possibilità tecnica. Per la maggior parte dei problemi di WooCommerce aiuta il seguente ordine:
| Passo | Quello che controlli |
|---|---|
| Problema | Che cosa non funziona esattamente? |
| Riproduzione | Si può riprodurre l'errore in modo affidabile? |
| Area | Prodotto, pagamento, spedizione, pagamento, ordine, e-mail o processo in background? |
| Ordine | Se presente: controllare lo stato, le note, il pagamento e la spedizione. |
| Stato del sistema | Ci sono versioni particolari, valori del server, plugin, note su temi o template? |
| Registri | C'è una voce corrispondente al momento dell'errore? |
| Modifiche | Cosa è stato modificato immediatamente prima della prima comparsa? |
| Test dei conflitti | È possibile identificare in modo controllato un'estensione o il tema coinvolto? |
| Soluzione | Risolvere ora in modo mirato la causa accertata. |
| Controllo | Eseguire nuovamente per intero il caso di test originale. |
Con questo metodo, un generico „WooCommerce non funziona“ si trasforma passo dopo passo in un problema concreto e analizzabile.
Riepilogo #
Una buona risoluzione dei problemi di WooCommerce non inizia con modifiche casuali, ma con una descrizione il più possibile accurata e un caso di test riproducibile.
Limita quindi l'area interessata. In caso di problemi con gli ordini, lo stato dell'ordine e le note dell'ordine forniscono spesso i primi indizi. Sotto WooCommerce → Stato trovi informazioni importanti sull'ambiente tecnico. Sotto WooCommerce → Stato → Registri puoi cercare errori che corrispondano al problema per tempi e contenuti.
Per i processi in background, dovresti controllare anche le azioni pianificate. Se si sospetta un conflitto di plugin o temi, questo dovrebbe essere verificato e, se possibile, testato in un ambiente di staging.
Cambia sempre una sola cosa alla volta e poi ripeti lo stesso test. In questo modo puoi determinare se una modifica ha effettivamente influenzato la causa.
E se il problema richiede competenze tecniche specialistiche, una diagnosi pulita è comunque preziosa: con lo stato del sistema, i log, il messaggio di errore e i passaggi riproducibili, il supporto competente può cercare la causa in modo molto più mirato.
