WordPress non funziona dopo l'aggiornamento: sintomo, causa e ritorno alla versione precedente
Quando WordPress non funziona dopo un aggiornamento, la causa di solito è un plugin, il tema o una versione PHP troppo vecchia. Prima riconosci il sintomo: schermata bianca, errore critico, messaggio di manutenzione bloccato o layout rotto. Poi disattiva o riporta indietro l'ultimo elemento aggiornato. In un negozio, controlla carrello e ordine prima di considerarlo risolto.
Autore: Il team TellMyShop. Una guida per i titolari di siti WordPress e negozi WooCommerce: la causa, la correzione a mano e lo stesso lavoro in una conversazione in chat.
Ultimo aggiornamento: · 6 min di lettura
Il sintomo indica la causa
Dopo un aggiornamento un sito può rompersi in diversi modi. Ognuno indica una causa diversa e una prima mossa diversa.
| Cosa vedi | Causa più comune | Prima mossa |
|---|---|---|
| «Si è verificato un errore critico sul sito» o una schermata bianca | la nuova versione del plugin non funziona con un altro plugin o con la versione PHP | disattiva il plugin aggiornato: email della modalità di recupero o file manager |
| Un messaggio di manutenzione programmata che non sparisce | l'aggiornamento si è interrotto a metà | elimina il file .maintenance nella cartella principale del sito |
| Il sito funziona, ma il layout è rotto | vecchi file di stile in cache | svuota la cache nel plugin, nel browser e nella CDN |
| Funziona tutto tranne il carrello o il pagamento | un aggiornamento di WooCommerce, di un gateway di pagamento o del tema del negozio | controlla log e versioni; se serve, riporta indietro quel plugin |
| La bacheca funziona ma il sito no (o il contrario) | un errore nella parte di codice che si carica solo lì | i log degli errori indicano il file e il plugin |
Se vedi un errore critico su tutto il sito, c'è una guida di soccorso a parte nell'articolo sull'errore critico di WordPress. Qui ci concentriamo su cosa fare quando sai che la colpa è di un aggiornamento, e su come tornare alla versione precedente.
Martedì dopo l'aggiornamento: come capire cosa è cambiato
Una situazione tipica: nella bacheca aspettano sette aggiornamenti, li spunti tutti e clicchi su aggiorna. Pochi minuti dopo un'amica ti scrive che non riesce a pagare nel negozio. Devi capire quale dei sette plugin è stato.
La memoria tradisce, quindi cerca le tracce. I plugin con gli aggiornamenti automatici attivi possono essere cambiati anche di notte, senza che tu abbia cliccato niente. I messaggi di errore contengono il percorso di un file, e in esso il nome della cartella del plugin. Gli hosting di solito mostrano il log degli errori PHP nel loro pannello. Se hai un negozio, WooCommerce registra gli errori fatali nei suoi log nella sezione stato del negozio.
Quando le tracce non dicono niente, disattiva i plugin aggiornati uno alla volta e controlla il sito dopo ognuno. Parti da quelli che toccano il problema: per il carrello WooCommerce e i gateway di pagamento; per il layout il tema e il page builder.
Come riportare indietro l'aggiornamento di un plugin passo per passo
Disattivare un plugin spegne l'incendio. Ma spesso quel plugin ti serve, quindi vuoi tornare alla versione che funzionava.
- Annota quale versione avevi. Il vecchio numero di versione è nell'email dell'aggiornamento automatico, nel changelog del plugin o nel backup.
- Un plugin della directory di wordpress.org: installa WP Rollback. Sotto ogni plugin della directory compare un link per scegliere una versione precedente. La guida di WPBeginner al rollback dei plugin mostra come appare. WP Rollback non può riportare indietro i plugin a pagamento fuori dalla directory.
- Un plugin a pagamento: scarica un file ZIP più vecchio dal tuo account presso l'autore del plugin e caricalo al posto della versione attuale, oppure chiedi a chi segue il sito di farlo.
- Il backup dell'hosting: se hai un negozio, chiedi di ripristinare solo i file del plugin, senza il database. Ripristinare il database cancellerà gli ordini arrivati dopo il backup.
- Spegni gli aggiornamenti automatici per quel solo plugin nell'elenco dei plugin, così domani la versione difettosa non torna. Riaccendili quando l'autore pubblica una correzione.
- Controlla il sito come un cliente: la home page, un articolo e, in un negozio, un prodotto, il carrello e un ordine di prova.
Come trovare il plugin colpevole disattivandoli è descritto nella guida di cyber_Folks ai conflitti tra plugin (in polacco).
Cosa fa WordPress da solo e cosa no
Dalla versione 6.6, dopo un aggiornamento automatico di un plugin WordPress controlla la home page. Quando restituisce un errore critico, ripristina la versione precedente e invia un'email all'amministratore. La descrizione di questa funzione la trovi nell'articolo di DreamHost sul rollback degli aggiornamenti automatici.
Questa rete ha maglie larghe. Non copre gli aggiornamenti cliccati a mano né i temi. E non noterà un errore che rompe solo il carrello, il pagamento o il layout, perché controlla solo la home page. Quindi con un negozio controllare il carrello dopo un aggiornamento resta compito tuo.
Come aiuta la chat dopo un aggiornamento
Quando è rotta solo una parte del sito e la bacheca risponde, la tua chat (Claude o ChatGPT) ti aiuta a capire cosa è cambiato. Con un errore su tutto il sito il plugin TellMyShop per WordPress e WooCommerce non parte, perché funziona dentro WordPress, quindi restano le strade descritte sopra.
Legge i log degli errori, raggruppa i messaggi ripetuti e indica il plugin o il tema da cui viene ognuno. Mostra l'elenco dei plugin con versioni, aggiornamenti automatici e versione PHP richiesta, oltre allo stato di salute del sito. Tutto questo funziona nella versione gratuita TellMyShop Free.
Tu: Dagli aggiornamenti di ieri il carrello non funziona. Cosa si è rotto?
La tua chat: I log hanno un nuovo errore critico, 12 volte da ieri. Viene dal plugin Example Cart Add-ons, versione 5.0, aggiornato in automatico. Gli altri sei plugin aggiornati non hanno errori.
La tua chat: Propongo di disattivare questo plugin e di ripristinare la versione più vecchia da un backup o dal tuo account presso l'autore. Anteprima:
Tu: Sì, disattivalo.
La tua chat: Disattivato. La home page risponde. Controlla il carrello con un ordine di prova. Puoi annullare la modifica dalla cronologia delle modifiche.
versione precedente: Example Cart Add-ons: attivo
nuova versione: Example Cart Add-ons: disattivato
Disattivare, attivare e aggiornare i plugin funziona in TellMyShop Pro dopo che hai acceso l'interruttore Plugin nel pannello. L'interruttore dura 24 ore e richiede un backup del database fatto lo stesso giorno. Per un aggiornamento l'anteprima mostra la versione attuale e quella nuova, parte del changelog e gli avvisi: un cambio di versione principale, un aggiornamento di WooCommerce o di un gateway di pagamento. Aggiorna al massimo 5 plugin alla volta e controlla la home page dopo ognuno.
I limiti sono due: la chat non riporta indietro in automatico l'aggiornamento di un plugin, e il plugin TellMyShop non fa backup dell'intero sito. La versione precedente la ripristina il backup dell'hosting o l'installazione di una versione più vecchia. La disattivazione di un plugin fatta dalla chat la annulli dalla cronologia delle modifiche.
Prima di cliccare di nuovo su Aggiorna
Queste abitudini risparmiano nervi e non richiedono uno sviluppatore:
- Aggiorna pochi plugin alla volta, non tutti insieme. È più facile trovare il colpevole.
- Prima di aggiornare, controlla che l'hosting abbia un backup recente, e sappi come ripristinarlo.
- I cambi di versione principale (per esempio da 4.x a 5.0) e gli aggiornamenti di WooCommerce falli quando hai tempo per controllare il negozio.
- Dopo l'aggiornamento fai un ordine di prova o chiedi alla chat un controllo del mattino con i nuovi errori dai log.
Come la chat legge log e salute del sito lo trovi nella pagina TellMyShop per WordPress e WooCommerce. Le licenze le confronti nella pagina prezzi, e altre guide le trovi sul blog.
Domande e risposte
Come torno alla versione precedente di un plugin WordPress?
Per i plugin della directory di wordpress.org il modo più semplice è il plugin WP Rollback, che installa una versione precedente scelta. Un plugin a pagamento lo riporti indietro caricando un file ZIP più vecchio fornito dall'autore. Quando la bacheca non funziona, prima disattiva il plugin dal file manager dell'hosting, poi torna alla versione precedente.
Il sito mostra un messaggio di manutenzione che non sparisce. Cosa faccio?
Vuol dire che l'aggiornamento si è interrotto a metà. WordPress ha lasciato un file .maintenance nella cartella principale del sito. Eliminalo nel file manager dell'hosting, ricarica il sito e ripeti l'aggiornamento del plugin che non è terminato.
WordPress annulla da solo gli aggiornamenti non riusciti?
In parte. Dalla versione 6.6 WordPress annulla un aggiornamento automatico di un plugin quando subito dopo la home page restituisce un errore critico. Questo non copre gli aggiornamenti cliccati a mano, i temi o gli errori che rompono l'aspetto, il carrello o altre pagine.
Dopo un aggiornamento il sito sembra rotto, ma funziona. Da dove parto?
Svuota la cache nel plugin di cache e nel browser, e se usi un servizio di tipo CDN, anche lì. Dopo l'aggiornamento di un tema o di un page builder spesso restano in cache vecchi file di stile. Se non aiuta, controlla quale plugin o tema è stato aggiornato per ultimo.
La chat riporta indietro l'aggiornamento di un plugin?
Non in automatico. La chat indica nei log e nell'elenco dei plugin cosa ha causato il problema e, in TellMyShop Pro, dopo che hai acceso l'interruttore Plugin, può disattivare quel plugin. La versione precedente la ripristina il backup dell'hosting o l'installazione di una versione più vecchia.
WordPress è un marchio della WordPress Foundation. WooCommerce è un marchio di Automattic Inc. Claude è un marchio di Anthropic PBC. ChatGPT e OpenAI sono marchi di OpenAI. TellMyShop non è affiliato a queste aziende.