Quando un aggiornamento WordPress fallisce, non ripetere subito l’operazione più volte. Controlla modalità manutenzione, spazio disco, versione PHP, permessi e log; poi scegli tra completamento manuale, ripristino circoscritto con JetBackup 5 oppure rollback del solo plugin o tema interessato.
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.
Questa procedura 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:
- esegui un backup della sua cartella;
- rinominala temporaneamente se il sito non si apre;
- verifica che il sito torni disponibile;
- scarica una copia integra dalla fonte ufficiale;
- controlla requisiti PHP e WordPress;
- 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-adminewp-includes; - carica i file core nella directory principale;
- non sostituire
wp-config.php; - non eliminare
wp-content; - visita
/wp-admin/upgrade.phpse 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:
| Problema | Ripristino iniziale consigliato |
|---|---|
| Plugin o tema danneggiato | Cartella specifica del componente |
| File core incompleti | File e cartelle dell’installazione, valutando wp-content |
| Aggiornamento con modifiche al database | Valutazione congiunta di file e database |
| Intero account compromesso dall’operazione | Ripristino completo solo dopo aver valutato email e dati recenti |
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.
Quando aprire un ticket Xlogic
Apri un ticket quando i file risultano incompleti, non riesci a individuare il punto JetBackup corretto, l’aggiornamento fallisce ripetutamente o compaiono errori di permessi e risorse.
Indica dominio, componente e versione, data e ora, messaggio completo, modifiche effettuate e punto di backup valutato. Non inviare password.
Fonti tecniche ufficiali
Domande frequenti sull’aggiornamento WordPress fallito
Posso ripetere subito l’aggiornamento?
Prima controlla se il processo è terminato, rimuovi eventuale .maintenance solo quando non è in corso e verifica spazio, log e integrità dei file. Ripetere alla cieca può sovrapporre le operazioni.
Devo ripristinare anche il database?
Non sempre. Per un plugin o tema spesso basta la cartella interessata. Ripristina il database soltanto quando l’aggiornamento lo ha modificato e dopo aver valutato i dati recenti.
La rimozione di .maintenance completa l’aggiornamento?
No. Rende nuovamente accessibile il sito, ma non ripara file mancanti o incompatibilità. Dopo la rimozione devi verificare versioni, log e integrità.
Perché l’aggiornamento fallisce per spazio insufficiente?
WordPress deve scaricare ed estrarre archivi oltre a conservare temporaneamente file. È quindi necessario spazio libero superiore alla sola dimensione del plugin o del core.
JetBackup 5 può ripristinare un solo plugin?
Puoi selezionare la cartella specifica del plugin in un punto disponibile. Controlla sempre percorso, data e contenuto prima di avviare il ripristino.