WordPress non funziona dopo un aggiornamento? Cosa fare ora

Se il tuo sito ha smesso di funzionare correttamente subito dopo un aggiornamento, qualcosa nella nuova versione non va d’accordo con il resto del sito.

Il problema può manifestarsi in modi diversi:

il layout sembra rotto o senza stili
WordPress mostra un errore critico
la bacheca non è più accessibile
è sparita una funzione, come un modulo, un menu o uno slider
il checkout o il passaggio di pagamento non funzionano più
il sito è bloccato su un messaggio di manutenzione

È uno dei problemi più comuni di WordPress, e di solito si risolve. Un aggiornamento andato male non significa necessariamente che contenuti, ordini o dati dei clienti siano andati persi.

La cosa più importante è capire quale aggiornamento ha causato il problema prima di provare ad annullarlo. Annullare la cosa sbagliata, o annullare tutto in una volta, può creare nuovi problemi oltre a quello iniziale.

Questa guida spiega quali aggiornamenti sono di solito coinvolti, quali controlli puoi fare in sicurezza, come tornare indietro con cautela e quando è meglio chiedere supporto tecnico.

Quale aggiornamento può aver causato il problema?

Un sito WordPress si aggiorna su più livelli. Ognuno può provocare un problema in modo diverso.

L’aggiornamento di un plugin

È il caso più frequente. Una nuova versione di un plugin potrebbe non essere compatibile con:

un altro plugin
il tema attivo
la versione di WordPress
la versione di PHP sul server
il codice personalizzato scritto per il tuo sito

La nuova versione non è necessariamente difettosa. A volte cambia semplicemente qualcosa su cui un altro componente faceva affidamento.

L’aggiornamento del core di WordPress

Le versioni principali di WordPress possono cambiare il comportamento dell’editor, dei blocchi o di alcune funzioni. I plugin, i temi o il codice personalizzato più vecchi, non aggiornati da tempo, sono quelli che rischiano di più.

L’aggiornamento del tema

Se il tema è stato personalizzato modificandone direttamente i file, un aggiornamento può sovrascrivere quelle modifiche. Spesso si presenta come un layout cambiato all’improvviso, sezioni mancanti o stili spariti.

Un tema child protegge le personalizzazioni dagli aggiornamenti del tema genitore. Se il tuo sito non lo usa, l’aggiornamento del tema è un motivo frequente di modifiche perse.

Un aggiornamento di PHP da parte dell’hosting

PHP è il linguaggio di programmazione su cui gira WordPress. I provider di hosting periodicamente dismettono le vecchie versioni di PHP e spostano i siti su quelle più recenti.

Questo tipo di aggiornamento può avvenire senza che nessuno acceda a WordPress. Se dalla tua parte nessuno ha aggiornato niente, chiedi al tuo provider di hosting se la versione di PHP è cambiata di recente.

Aggiornamenti automatici

WordPress può aggiornarsi da solo, e plugin e temi possono essere impostati per aggiornarsi in automatico. Alcuni provider di hosting eseguono anche gli aggiornamenti per conto tuo.

Questo significa che un sito può rompersi durante la notte anche se nessuno l’ha toccato. Controlla lo storico degli aggiornamenti nel pannello dell’hosting o chiedi a chi gestisce il sito.

Prima di tutto: cerca di capire cosa è stato aggiornato

Non serve essere tecnici per raccogliere informazioni utili.

Pensa a cosa è successo subito prima che comparisse il problema:

Hai cliccato "Aggiorna" su un solo plugin o su diversi contemporaneamente?
Hai aggiornato WordPress?
Hai aggiornato il tema?
Qualcun altro ha lavorato sul sito?
Hai ricevuto un’email che diceva che gli aggiornamenti sono stati installati in automatico?
Il provider di hosting ha annunciato una modifica a PHP o al server?

Se non sai cosa è stato aggiornato, apri:

Dashboard → Updates (Bacheca → Aggiornamenti)

Poi:

Plugins → Installed Plugins (Plugin → Plugin installati)

L’elenco dei plugin mostra la versione attuale di ciascun plugin. Confrontarla con quello che ricordi, o con il report di un backup recente, può aiutarti a capire cosa è cambiato.

WordPress può anche inviare un’email all’indirizzo dell’amministratore dopo gli aggiornamenti automatici o quando rileva un errore critico. Controlla la posta in arrivo e la cartella spam.

Annota tutto ciò che trovi. Una nota come "il problema è iniziato dopo aver aggiornato tre plugin stamattina" è già molto utile.

Svuota la cache prima di tutto il resto

A volte il sito in realtà è a posto, ma stai vedendo una sua versione vecchia o mista.

Dopo un aggiornamento, i file in cache possono combinare codice nuovo con stili o script vecchi. Il layout può così sembrare rotto quando il problema di fondo è solo temporaneo.

Controlla questi livelli, uno alla volta:

Cache del browser: apri il sito in una finestra privata o in incognito, oppure prova un altro browser.
Plugin di cache: se usi un plugin di cache o di prestazioni, usa la sua opzione per svuotare la cache.
Cache dell’hosting: molti provider di hosting hanno una propria cache, che si può svuotare dal pannello dell’hosting.
CDN: se il sito usa un servizio come Cloudflare, svuota la cache dalla dashboard del servizio.

Se dopo aver svuotato la cache il sito si vede correttamente, provalo di nuovo da un altro dispositivo e controlla le funzioni importanti per conferma.

Se il problema c’è ancora, molto probabilmente l’aggiornamento ha causato un vero problema di compatibilità.

Verifica esattamente cosa non funziona

Apri il sito in una finestra privata e prova la homepage, una pagina interna, la pagina di login, la bacheca e le principali funzioni di business, come moduli, carrello, checkout o prenotazioni.

Annota cosa funziona e cosa no. Per esempio, le pagine potrebbero sembrare a posto mentre il modulo di contatto non invia più, o il negozio potrebbe funzionare fino al passaggio di pagamento.

Sapere esattamente dove si presenta il problema spesso porta dritto al plugin o alla funzione coinvolti.

Cosa puoi provare in sicurezza?

L’approccio giusto dipende da quanto è importante il sito e da quanta dimestichezza hai con la gestione di WordPress.

Opzione 1: contatta chi ha eseguito l’aggiornamento

Se l’aggiornamento l’ha fatto un’agenzia, uno sviluppatore, un collega o il provider di hosting, contatta prima loro.

Chiedi quali componenti sono stati aggiornati, in che ordine, se sono comparsi avvisi e se è stato fatto un backup subito prima.

Opzione 2: disattiva il plugin appena aggiornato

Prova solo se riesci ad accedere alla bacheca e sei abbastanza sicuro di quale plugin sia coinvolto.

Vai su:

Plugins → Installed Plugins (Plugin → Plugin installati)

Disattiva solo il plugin sospetto, poi controlla se il problema scompare.

Tieni presente che i plugin possono gestire funzioni importanti come pagamenti, abbonamenti, moduli, sicurezza o traduzioni. Se il sito torna a sembrare a posto, la funzione offerta da quel plugin ora manca. Verificala prima di decidere come procedere.

Opzione 3: riporta il plugin o il tema alla versione precedente

Se un aggiornamento specifico ha causato il problema, tornare alla versione precedente può essere una soluzione temporanea ragionevole.

Prima di tornare indietro:

fai un backup completo del sito attuale, database compreso
verifica quale versione era installata prima dell’aggiornamento
controlla il changelog del plugin, se disponibile, per vedere se l’aggiornamento includeva correzioni di sicurezza

I rischi importanti sono due:

Alcuni aggiornamenti modificano anche il database. Tornare ai vecchi file del plugin non sempre annulla quelle modifiche, e la versione precedente potrebbe non funzionare bene con i dati aggiornati.
Se l’aggiornamento correggeva una vulnerabilità di sicurezza, tornare indietro la lascia di nuovo aperta.

Tornare a una versione precedente deve servire a guadagnare tempo, non diventare definitivo. L’obiettivo è capire l’incompatibilità e tornare il prima possibile a una versione aggiornata e funzionante.

Plugin e temi premium spesso non sono disponibili nella directory di WordPress.org. Le versioni precedenti potrebbero dover essere scaricate dall’account del produttore.

Opzione 4: ripristina un backup

Un ripristino può essere la scelta giusta quando il sito si è rotto subito dopo un aggiornamento noto ed esiste un backup affidabile fatto appena prima.

Tuttavia, un ripristino riporta l’intero sito a com’era al momento del backup. Tutto ciò che è stato creato dopo quel momento può essere sovrascritto, compresi:

ordini
pagamenti registrati sul sito
account dei clienti
rinnovi degli abbonamenti
invii dei moduli
modifiche ai contenuti

Questo è particolarmente importante per i siti WooCommerce, con aree riservate o con prenotazioni. Anche poche ore di ordini persi possono creare seri problemi con clienti, magazzino e contabilità.

Su questi siti, non ripristinare un backup senza prima aver verificato quali dati andrebbero persi. A volte è possibile ripristinare solo i file, o conservare gli ordini recenti ripristinando il resto.

D4Hub può aiutarti a decidere se un ripristino è appropriato e come proteggere i dati più recenti.

Cosa dovresti evitare di fare?

Quando il sito non funziona, è naturale voler provare tutto in fretta. Spesso questo rende più difficile trovare il problema iniziale.

Evita di:

eseguire gli altri aggiornamenti in sospeso sperando che risolvano il problema
disattivare tutti i plugin in una volta su un negozio online attivo
cancellare plugin o temi senza un backup
ripristinare un vecchio backup senza controllarne la data
cambiare la versione di PHP avanti e indietro
reinstallare WordPress sopra l’installazione esistente senza un backup
modificare il database
copiare codice dai forum senza capirlo
fare più modifiche prima di verificarne il risultato

Cambia una cosa alla volta e annota cosa hai fatto e cosa è successo dopo ogni passaggio.

Se hai dubbi, fermarti è spesso più sicuro che continuare. D4Hub può riprendere l’indagine in qualsiasi momento, anche dopo un tentativo non riuscito.

Come evitarlo la prossima volta?

Gli aggiornamenti sono necessari: correggono bug e vulnerabilità di sicurezza, e saltarli a lungo di solito rende più rischioso l’aggiornamento successivo. L’obiettivo è aggiornare in sicurezza, non smettere di aggiornare.

Una routine più sicura di solito comprende:

un ambiente di staging: una copia privata del sito in cui gli aggiornamenti vengono testati prima di arrivare al sito online. Molti provider di hosting lo offrono.
un backup subito prima di aggiornare: file e database, da un sistema di backup che sai di poter davvero ripristinare.
piccoli gruppi: aggiornare un plugin o pochi alla volta rende molto più facile trovare la causa.
aggiornamenti automatici gestiti con attenzione: sono utili per la sicurezza, ma per i plugin che gestiscono pagamenti o abbonamenti molte aziende preferiscono aggiornare a mano dopo un test. Puoi attivarli o disattivarli per ogni plugin da Plugins → Installed Plugins (Plugin → Plugin installati).
un test veloce subito dopo: controlla moduli, checkout e le altre funzioni più importanti per la tua attività.

Quando conviene chiedere supporto tecnico?

Il supporto tecnico è consigliato quando:

l’intero sito è irraggiungibile
sono coinvolti checkout, pagamenti o abbonamenti
non riesci ad accedere alla bacheca
non sai quale aggiornamento ha causato il problema
più componenti sono stati aggiornati contemporaneamente
non hai un backup recente e verificato
il sito gestisce ordini o dati dei clienti che non si possono perdere
il problema riguarda codice personalizzato o un tema modificato
tornare a una versione precedente non ha risolto il problema, o ne ha creati di nuovi
il provider di hosting ha cambiato la versione di PHP e il sito non funziona più

Non serve diagnosticare il problema da solo prima di chiedere aiuto.

Quali informazioni conviene raccogliere?

Prima di aprire una richiesta di supporto, raccogli ciò che hai facilmente a disposizione:

l’URL del sito
screenshot del problema
l’ora approssimativa in cui è iniziato il problema
quali aggiornamenti sono stati eseguiti, se lo sai
se gli aggiornamenti erano manuali o automatici
quali pagine o funzioni sono coinvolte
se la bacheca è accessibile
eventuali email ricevute da WordPress o dal provider di hosting
il nome del provider di hosting
se è disponibile un backup precedente all’aggiornamento

Non inviare password o dati di accesso con una normale email, e non pubblicare nei forum screenshot che mostrano credenziali o log di errore completi.

Se non riesci a fornire tutto, va bene lo stesso. D4Hub può aiutarti a capire cos’altro serve.

Come può aiutarti D4Hub

L’obiettivo non è solo far funzionare di nuovo il sito oggi. È anche capire cosa si è rotto, così il prossimo aggiornamento non causerà lo stesso problema.

A seconda della situazione, D4Hub può aiutarti a:

individuare quale aggiornamento ha causato il problema
verificare la compatibilità tra WordPress, plugin, tema e PHP
riportare in sicurezza un plugin, un tema o WordPress a una versione precedente
valutare se ripristinare un backup e quali dati potrebbero andare persi
conservare ordini recenti e dati dei clienti durante un ripristino
riparare il codice personalizzato che ha smesso di funzionare dopo un aggiornamento
coordinarsi con il provider di hosting su modifiche a PHP o al server
testare checkout, moduli, login e le altre funzioni importanti
impostare un ambiente di staging per testare gli aggiornamenti futuri
rivedere le impostazioni degli aggiornamenti automatici e la tua routine di aggiornamento

Puoi chiedere supporto in qualsiasi fase del processo.

Per esempio, D4Hub può dirti se nel tuo caso è sicuro tornare a una versione precedente o ripristinare un backup, intervenire quando la bacheca è inaccessibile o controllare il sito dopo una soluzione temporanea.

Se qualche passaggio di questa guida ti sembra poco chiaro o rischioso, non devi farlo da solo.

Apri un ticket di supporto

Per chi vuole fare da sé: controlli tecnici e ritorno a versioni precedenti

I controlli che seguono sono pensati per chi ha dimestichezza con i pannelli di hosting, SFTP, la riga di comando e WP-CLI.

Fai un backup completo di file e database prima di qualsiasi modifica. Assicurati di lavorare sull’installazione WordPress corretta e cambia una cosa alla volta.

Controllare le versioni di WordPress, dei plugin e di PHP

Con WP-CLI, esegui questi comandi dalla cartella principale di WordPress.

Controlla la versione di WordPress:

wp core version

Elenca i plugin con il loro stato e la versione attuale:

wp plugin list --fields=name,status,version,update_version

Fai lo stesso per i temi:

wp theme list

WP-CLI non mostra uno storico di quando ogni plugin è stato aggiornato. Confronta le versioni con i report dei backup, le email di aggiornamento di WordPress o lo storico degli aggiornamenti nel pannello dell’hosting.

Controlla le informazioni su PHP per la riga di comando:

wp --info

oppure:

php -v

Tieni presente che la versione di PHP usata dalla riga di comando può essere diversa da quella usata dal sito. Il pannello dell’hosting di solito mostra la versione di PHP assegnata al sito.

Eseguire WP-CLI quando il sito ha un errore fatale

Se un plugin o un tema causa un errore fatale, anche i comandi WP-CLI potrebbero non funzionare. Puoi evitare di caricare plugin e temi:

wp plugin list --skip-plugins --skip-themes

Disattivare un plugin

Con WP-CLI:

wp plugin deactivate plugin-slug

Senza WP-CLI, apri il file manager dell’hosting o collegati via SFTP e vai in:

wp-content/plugins/

Rinomina la cartella del plugin sospetto, per esempio da plugin-slug a plugin-slug-disabled. WordPress non lo caricherà più. Non cancellare la cartella.

Riportare un plugin a una versione specifica

Per i plugin presenti nella directory di WordPress.org, puoi reinstallare una versione precedente:

wp plugin install plugin-slug --version=1.2.3 --force

Sostituisci plugin-slug con il nome della cartella del plugin e 1.2.3 con la versione installata prima dell’aggiornamento. Le versioni precedenti sono elencate in "Advanced View" (Visualizzazione avanzata) nella pagina del plugin su WordPress.org.

Questo non funziona per i plugin premium che non sono nella directory. Ricorda che riportare indietro i file non annulla le modifiche al database fatte dalla versione più recente.

Verificare se un aggiornamento si è interrotto

Se il sito mostra a lungo un messaggio come "Briefly unavailable for scheduled maintenance" (Momentaneamente non disponibile per manutenzione programmata), un aggiornamento potrebbe essersi fermato a metà.

Cerca un file chiamato .maintenance nella cartella principale di WordPress. Rimuoverlo chiude la modalità manutenzione, ma l’aggiornamento interrotto potrebbe aver lasciato file incompleti che vanno comunque controllati.

Per verificare se i file core di WordPress corrispondono alla versione ufficiale:

wp core verify-checksums

Attivare un log di debug temporaneo

Per vedere l’errore effettivo, puoi attivare il log in wp-config.php, prima della riga che invita a smettere di modificare il file:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Riproduci il problema una volta, poi leggi:

wp-content/debug.log

Disattiva di nuovo il debug quando hai finito. I log possono contenere percorsi dei file e altre informazioni riservate: non pubblicarli.

D4Hub può aiutarti a leggere i risultati, scegliere il modo più sicuro per tornare indietro e testare il sito dopo l’intervento.

Domande frequenti

Ho perso contenuti o ordini?

Di solito no. Un aggiornamento che rompe il sito normalmente riguarda il codice, non i contenuti salvati nel database.

Il rischio maggiore è quello che succede dopo: ripristinare un vecchio backup senza controllarlo può sovrascrivere ordini o contenuti recenti. Controlla prima di ripristinare.

Devo semplicemente ripristinare il backup precedente all’aggiornamento?

Su un semplice sito vetrina senza modifiche recenti, può essere una soluzione rapida.

Su un negozio, un sito con aree riservate o con prenotazioni, un ripristino può eliminare ordini, pagamenti e registrazioni creati dopo il backup. Controlla prima la data del backup e cosa andrebbe perso.

Posso smettere di aggiornare WordPress per evitare il problema?

Non in sicurezza. Gli aggiornamenti spesso includono correzioni di sicurezza, e i plugin non aggiornati sono una via comune con cui i siti vengono compromessi. È meglio cambiare il modo in cui aggiorni: staging, backup e gruppi più piccoli.

Devo disattivare gli aggiornamenti automatici?

Non necessariamente. Gli aggiornamenti automatici possono essere molto utili per la sicurezza. Molte aziende li tengono attivi per le versioni minori di WordPress e per i plugin a basso rischio, e aggiornano a mano i plugin critici dopo un test.

Il mio hosting ha aggiornato PHP. Devo chiedere di tornare alla versione precedente?

Può essere una soluzione a breve termine se la vecchia versione è ancora disponibile. Tuttavia, le vecchie versioni di PHP smettono di ricevere aggiornamenti di sicurezza. La soluzione a lungo termine è rendere il sito compatibile con la versione più recente.

D4Hub può aiutarmi se ho già provato a sistemarlo?

Sì. Spiega cosa hai provato e cosa è successo dopo ogni passaggio. Questo aiuta a ricostruire l’incidente e a decidere la prossima azione sicura.

Il sito WordPress non funziona più dopo un aggiornamento: cosa devo fare?