Aggiornamento WordPress fallito: recupero sicuro con JetBackup 5

In breve: Aggiornamento WordPress fallito: Quando un aggiornamento WordPress fallisce, non ripetere subito l’operazione più volte.

Aggiornamento WordPress fallito

Un aggiornamento può interrompersi per timeout, memoria, spazio esaurito, connessione, permessi, incompatibilità o chiusura del browser. Il sito può restare in manutenzione, mostrare un errore critico oppure funzionare solo parzialmente perché alcuni file sono stati sostituiti e altri no.

aggiornamento WordPress fallito spiega come gestire un aggiornamento WordPress fallito riducendo il rischio di perdita dati.

Riconosci quale aggiornamento è fallito

Prima di intervenire stabilisci se riguardava:

• core di WordPress;
• un singolo plugin;
• un tema;
• traduzioni;
• più componenti aggiornati insieme;
• aggiornamento automatico in background.

Annota la versione precedente, quella prevista e l’ora. Se non ricordi il componente, controlla email amministrativa, log, cronologia del browser e date dei file.

1. Non chiudere o ripetere indiscriminatamente

Se la schermata mostra ancora avanzamento, attendi alcuni minuti. Un aggiornamento può richiedere tempo per estrazione e sostituzione dei file. Non aprire più finestre e non avviare contemporaneamente altri aggiornamenti.

Se il sito è già bloccato, evita di premere ripetutamente “Aggiorna ora”: potresti sovrapporre richieste e rendere più difficile capire quale operazione ha modificato i file.

2. Controlla il file.maintenance

WordPress crea .maintenance nella cartella principale durante l’aggiornamento. Se l’operazione si interrompe, il file può restare presente e mostrare:

Momentaneamente non disponibile per manutenzione programmata. Riprovare tra un minuto.

Attendi alcuni minuti. Se non esiste più alcun processo di aggiornamento, mostra i file nascosti in Gestione file e rimuovi solamente .maintenance. La guida dedicata spiega il controllo completo.

3. Verifica spazio e inode

L’aggiornamento deve scaricare un archivio, estrarlo e sostituire file. Controlla in cPanel:

• spazio disco disponibile;
• numero di inode;
• archivi e backup lasciati nella home;
• cache e file temporanei;
• dimensione di log e cartelle di staging.

Non cancellare dati casualmente. Rimuovi soltanto file identificati e conserva una copia quando non sei sicuro.

4. Controlla PHP e risorse

Consulta PHP Selector in cPanel e Limiti PHP. Verifica:

• versione PHP compatibile;
• memory_limit;
• max_execution_time;
• Resource Usage e Fault;
• eventuali errori di memoria o timeout.

Aumentare i valori senza diagnosi può mascherare un plugin difettoso. Usa i log per individuare il limite effettivamente raggiunto.

5. Controlla il registro degli errori

Consulta Metriche → Errori, error_log e, se configurato, wp-content/debug.log. Cerca:

• permission denied;
• no space left on device;
• allowed memory size exhausted;
• maximum execution time exceeded;
• fatal error nel plugin o tema aggiornato;
• file mancante o funzione non definita.

6. Se è fallito un plugin o un tema

Se il componente è chiaramente indicato:

1. esegui un backup della sua cartella;
2. rinominala temporaneamente se il sito non si apre;
3. verifica che il sito torni disponibile;
4. scarica una copia integra dalla fonte ufficiale;
5. controlla requisiti PHP e WordPress;
6. reinstalla o ripristina solamente quel componente.

Non scaricare plugin o temi da siti non ufficiali. Non sovrascrivere un tema personalizzato senza verificare la presenza di modifiche non salvate in un child theme.

7. Se è fallito l’aggiornamento del core

WordPress documenta una procedura di aggiornamento manuale. Prima crea una copia completa. In sintesi:

• scarica WordPress dalla fonte ufficiale;
• disattiva i plugin se necessario;
• sostituisci wp-admin e wp-includes;
• carica i file core nella directory principale;
• non sostituire wp-config.php;
• non eliminare wp-content;
• visita /wp-admin/upgrade.php se richiesto.

La procedura manuale deve essere eseguita soltanto se sai distinguere file core e contenuti. In alternativa utilizza un ripristino o richiedi assistenza.

8. Ripristino sicuro con JetBackup 5

JetBackup 5 permette di selezionare un punto precedente. La scelta dipende dall’aggiornamento:

Consulta Ripristinare file e cartelle con JetBackup 5. Un rollback del database può eliminare ordini, utenti, commenti o modifiche successive al punto scelto. Prima di ripristinarlo esporta i dati recenti quando possibile.

Aggiornamenti che modificano il database

Alcuni plugin e aggiornamenti del core eseguono migrazioni del database. Il ripristino dei soli file può quindi riportare il codice a una versione precedente lasciando tabelle e opzioni in uno stato più recente. Prima del rollback controlla se il componente mostra un messaggio di aggiornamento database, se ha creato nuove tabelle oppure se il changelog segnala migrazioni.

Su WooCommerce, membership, LMS e gestionali evita di ripristinare il database senza una valutazione: tra il punto di backup e il momento del problema possono essere arrivati ordini, pagamenti, registrazioni o modifiche di inventario. Quando possibile, metti il sito in modalità controllata, esporta i dati recenti e scegli il ripristino più circoscritto.

Come verificare che il pacchetto scaricato sia integro

Se reinstalli manualmente un plugin, un tema o WordPress, usa esclusivamente la fonte ufficiale e verifica che l’archivio si apra senza errori. Non caricare un archivio parziale sopra la cartella esistente senza sapere quali file verranno sostituiti. Per un plugin puoi rinominare la vecchia directory, caricare la copia pulita e confrontare successivamente eventuali file personalizzati.

Dopo il recupero non aggiornare nuovamente tutti i componenti insieme. Ripeti un solo aggiornamento, controlla log e funzioni e passa al successivo soltanto quando il sito è stabile.

9. Verifiche dopo il recupero

• homepage, pagine interne e amministrazione;
• versione WordPress, plugin e tema;
• moduli di contatto e invio email;
• carrello, checkout e area cliente;
• permalink e file .htaccess;
• cron e pubblicazioni programmate;
• cache LiteSpeed;
• log PHP e Resource Usage.

Esegui un purge della cache solamente dopo aver verificato che i file corretti siano presenti.

Come prevenire nuovi fallimenti

• aggiorna un componente alla volta;
• crea un backup prima degli aggiornamenti importanti;
• verifica compatibilità PHP e changelog;
• mantieni spazio e inode liberi;
• evita aggiornamenti durante importazioni o backup;
• usa un ambiente di staging per siti complessi;
• non lasciare plugin e temi abbandonati.

Domande frequenti

Guide Xlogic correlate

• WordPress: un altro aggiornamento è in corso
• Come rimuovere il file .maintenance dopo un aggiornamento bloccato
• WordPress aggiornamenti in background non funzionano

Fonti tecniche

• WordPress: Updating WordPress
• WordPress: Dashboard Updates
• WordPress: Upgrading