Un errore aggiornamento WordPress può comparire mentre installi una nuova versione del CMS, aggiorni un plugin o un tema. In alcuni casi l’operazione si interrompe senza conseguenze evidenti; in altri il sito rimane bloccato in manutenzione, mostra un errore critico oppure smette temporaneamente di funzionare.
La cosa più importante è evitare di ripetere l’aggiornamento alla cieca. Prima bisogna capire quale componente non si è aggiornato e in quale fase si è verificato il problema.
Prima di modificare file, database o configurazioni del server, assicurati inoltre di avere un backup recente del sito. La documentazione ufficiale di WordPress sugli aggiornamenti raccomanda di eseguire un backup prima degli interventi più importanti.
In breve: quando un aggiornamento WordPress fallisce, le cause più frequenti riguardano modalità manutenzione rimasta attiva, permessi del filesystem, spazio disco insufficiente, timeout del server, problemi di connessione o incompatibilità tra WordPress, plugin, tema e PHP. Il messaggio mostrato dal CMS è spesso il primo indizio per individuare la causa corretta.
Attenzione: se visualizzi “Aggiornamento fallito” mentre stai semplicemente salvando una pagina o un articolo, ma non stai aggiornando WordPress, un plugin o un tema, potresti avere un problema differente legato all’editor o alla REST API. Trovi questo caso più avanti nella guida.
Errore aggiornamento WordPress: perché può verificarsi?
Durante un aggiornamento WordPress deve scaricare un pacchetto, decomprimerlo, verificare i file e sostituire quelli della versione precedente.
È sufficiente che uno di questi passaggi venga interrotto perché l’operazione fallisca.
Le cause più comuni sono:
- permessi o proprietà dei file non corretti;
- spazio disponibile sul server insufficiente;
- timeout durante il download;
- limiti delle risorse PHP;
- problemi di comunicazione con WordPress.org;
- aggiornamento precedente rimasto incompleto;
- incompatibilità tra WordPress, plugin, tema o PHP;
- file del core danneggiati;
- problemi temporanei dell’hosting;
- interruzione della connessione durante l’aggiornamento.
Un buon punto di partenza è Strumenti → Salute del sito. WordPress può mostrare informazioni utili sulla versione PHP, sul server, sulle richieste HTTP, sulla comunicazione con WordPress.org e sui permessi delle directory.
Puoi approfondire il funzionamento dello strumento nella documentazione ufficiale di Salute del sito.
Identifica il messaggio di errore prima di intervenire
Non tutti gli errori di aggiornamento hanno la stessa soluzione.
Per individuare la causa di un errore aggiornamento su WordPress, il punto di partenza più utile è il messaggio mostrato dal CMS.
Prima di modificare qualcosa, individua quindi il messaggio o il comportamento che compare sul sito.
| Messaggio o sintomo | Primo controllo da effettuare |
|---|---|
| “Momentaneamente non disponibile per manutenzione” | File .maintenance |
| “Impossibile copiare il file” | Permessi, ownership e spazio disco |
| “Download fallito” | Connessione server, timeout e WordPress.org |
cURL error 28 | Timeout durante le richieste HTTP |
| “Un altro aggiornamento è attualmente in corso” | Lock dell’aggiornamento |
| Errore critico dopo l’update | Plugin, tema, PHP e log degli errori |
| Solo un plugin non si aggiorna | Plugin, licenza, file o compatibilità |
| “La risposta non è una risposta JSON valida” | REST API, URL, server o plugin |
Questa distinzione è importante perché, per esempio, modificare i permessi dei file non serve a nulla se il problema reale è un timeout del server.
Se gli aggiornamenti e la manutenzione vengono gestiti solo quando compare un errore, può essere utile impostare una corretta gestione del sito WordPress con procedure di backup, aggiornamento e controllo periodico.
WordPress è bloccato in modalità manutenzione
Durante un aggiornamento WordPress crea temporaneamente un file chiamato .maintenance nella directory principale dell’installazione.
Normalmente viene eliminato automaticamente al termine dell’operazione. Se però l’aggiornamento viene interrotto, il file può rimanere sul server e il sito può continuare a mostrare un messaggio come:
Momentaneamente non disponibile per manutenzione. Riprovare tra un minuto.
In questo caso:
- attendi qualche minuto per verificare che l’aggiornamento non sia ancora in corso;
- accedi al server tramite SFTP o File Manager;
- apri la directory principale dell’installazione WordPress;
- individua il file
.maintenance; - eliminalo;
- ricarica il sito;
- controlla lo stato dell’aggiornamento che si era interrotto.
La rimozione di .maintenance consente generalmente di riaprire il sito, ma non elimina necessariamente la causa che ha fatto fallire l’aggiornamento.
WordPress include questa casistica anche nella propria documentazione sugli errori comuni.
“Impossibile copiare il file”: verifica permessi e ownership
Se WordPress mostra messaggi come:
Aggiornamento fallito: impossibile copiare il file
il CMS potrebbe non avere i permessi necessari per modificare una directory o sostituire un file.
Puoi effettuare una prima verifica da:
Strumenti → Salute del sito → Informazioni → Permessi filesystem
Bisogna però distinguere tra permessi e ownership, cioè la proprietà dei file sul server. Anche permessi apparentemente corretti possono non essere sufficienti se PHP viene eseguito con un utente differente da quello proprietario dei file.
Evita soprattutto di impostare indiscriminatamente permessi 777 soltanto per riuscire a completare l’aggiornamento.
I permessi eccessivamente permissivi possono creare problemi di sicurezza. WordPress raccomanda configurazioni coerenti con il server e il più restrittive possibile.
Puoi consultare la documentazione WordPress sui permessi dei file.
Se non conosci la configurazione del tuo hosting, chiedi al provider di verificare ownership e permessi dell’installazione WordPress.
Download fallito o cURL error 28 durante l’aggiornamento
Se l’errore compare durante il download del pacchetto e contiene messaggi come:
cURL error 28;operation timed out;download fallito;- richiesta scaduta;
il problema può essere legato al tempo necessario al server per comunicare con WordPress.org o scaricare i file.
In questo caso controlla:
- eventuali problemi temporanei dell’hosting;
- timeout delle richieste HTTP;
- firewall o sistemi di sicurezza;
- possibilità del server di raggiungere WordPress.org;
- spazio disponibile;
- eventuali errori registrati nei log.
Anche Salute del sito può segnalare problemi nelle richieste HTTP o nella comunicazione con i server WordPress.
Se tutti gli aggiornamenti smettono improvvisamente di funzionare nello stesso momento, è generalmente più sensato controllare prima il server rispetto a cercare un errore in ogni singolo plugin.
Controlla spazio disponibile, PHP e risorse del server
Un aggiornamento non consiste semplicemente nel sovrascrivere alcuni file.
WordPress deve scaricare e decomprimere il pacchetto prima di completare l’installazione. Questo richiede temporaneamente spazio e risorse.
Se l’errore compare durante download o decompressione, controlla principalmente:
- spazio disco;
- timeout;
- connettività;
- permessi del filesystem.
Se invece l’aggiornamento termina ma subito dopo compare un errore critico, controlla soprattutto:
- versione PHP;
- compatibilità del plugin o tema;
- log PHP;
- eventuali errori fatali;
- altri componenti aggiornati contemporaneamente.
Puoi trovare molte di queste informazioni in:
Strumenti → Salute del sito → Informazioni → Server
Questo approccio permette di restringere la diagnosi senza modificare impostazioni che non hanno alcun rapporto con l’errore.
Errore aggiornamento WordPress dopo un update di plugin o tema
Un’altra situazione frequente si verifica quando l’aggiornamento sembra completarsi correttamente ma, subito dopo, il sito mostra:
- errore critico;
- schermata bianca;
- errore 500;
- problemi nel frontend;
- funzionalità improvvisamente non disponibili.
In questo caso il problema può essere un’incompatibilità introdotta dalla nuova versione.
Se WordPress rileva un errore fatale, può inviare all’indirizzo email dell’amministratore un collegamento per accedere alla modalità di ripristino e individuare il componente responsabile.
Le versioni moderne di WordPress integrano inoltre meccanismi di protezione per gli aggiornamenti falliti di plugin e temi. Negli aggiornamenti manuali, WordPress può conservare temporaneamente la versione precedente del componente e ripristinarla se l’installazione non viene completata correttamente.
Prima di sostituire manualmente file via FTP, quindi, controlla sempre il messaggio mostrato nella dashboard e lo stato effettivo del plugin o del tema.
Se non riesci più ad accedere alla bacheca, puoi anche disattivare temporaneamente un plugin tramite SFTP o File Manager rinominandone la relativa cartella.
Durante la diagnosi evita inoltre di aggiornare molti componenti contemporaneamente. Procedere uno alla volta rende molto più semplice individuare l’aggiornamento che ha causato il problema.
“Un altro aggiornamento è attualmente in corso”
WordPress impedisce che due aggiornamenti del core vengano eseguiti contemporaneamente.
Per questo può comparire il messaggio:
Un altro aggiornamento è attualmente in corso.
WordPress utilizza un blocco temporaneo chiamato core_updater.lock. Il lock standard viene mantenuto per circa 15 minuti, quindi se hai appena avviato un aggiornamento normalmente è sufficiente attendere prima di riprovare.
Se il messaggio continua a comparire anche dopo che nessun aggiornamento è realmente attivo, il lock potrebbe essere rimasto registrato da un processo precedente.
Gli utenti tecnici possono verificarlo anche tramite database o WP-CLI. Ad esempio, WP-CLI permette di rimuovere la voce con:
wp option delete core_updater.lock
Questa operazione deve però essere eseguita soltanto dopo aver verificato che non ci sia realmente un aggiornamento in corso, altrimenti si rischia di avviare due processi contemporaneamente.
Quando aggiornare WordPress manualmente
Se l’aggiornamento automatico continua a fallire nonostante filesystem e server risultino corretti, può diventare necessario procedere con un aggiornamento manuale del core WordPress.
In linea generale la procedura prevede la sostituzione dei file del core, comprese le directory wp-admin e wp-includes, mantenendo invece correttamente i contenuti e la configurazione del sito.
Bisogna prestare particolare attenzione a:
wp-config.php;- directory
wp-content; - upload;
- plugin;
- temi;
- eventuali personalizzazioni.
Non improvvisare la procedura copiando semplicemente tutti i file della nuova versione sopra quelli esistenti senza sapere cosa stai sostituendo.
La procedura ufficiale per aggiornare WordPress spiega anche come procedere manualmente.
Se non hai esperienza con SFTP, backup e struttura dei file WordPress, è preferibile evitare tentativi casuali: un aggiornamento fallito è spesso più semplice da recuperare rispetto a un’installazione modificata in modo errato.
“Aggiornamento fallito” quando salvi una pagina? È un altro problema
Se “Aggiornamento fallito” compare mentre stai salvando una pagina o un articolo, non stai necessariamente affrontando un errore nell’aggiornamento di WordPress.
Messaggi come:
Aggiornamento fallito. La risposta non è una risposta JSON valida.
sono spesso collegati alla comunicazione tra l’editor WordPress e la REST API.
Tra le possibili cause rientrano:
- URL WordPress configurati in modo errato;
- problemi HTTPS;
- permalink;
- firewall;
- plugin di sicurezza;
- problemi del server;
- REST API non raggiungibile.
In questa situazione aggiornare manualmente WordPress o modificare i permessi dei file non dovrebbe essere la prima soluzione. Bisogna invece verificare le richieste REST e la configurazione dell’editor.
Quando conviene ripristinare il backup
Il ripristino da backup può essere la scelta più prudente quando il sito funzionava correttamente subito prima dell’aggiornamento e l’intervento ha compromesso funzionalità importanti.
È particolarmente rilevante per siti che gestiscono:
- ordini WooCommerce;
- pagamenti;
- prenotazioni;
- richieste commerciali;
- registrazioni;
- aree riservate.
In questi casi la priorità è spesso riportare online il servizio.
L’aggiornamento problematico può poi essere analizzato in un ambiente di staging, senza continuare a sperimentare direttamente sul sito pubblico.
Come prevenire gli errori di aggiornamento WordPress
Non è possibile eliminare completamente il rischio di un aggiornamento problematico, ma è possibile ridurlo sensibilmente.
Prima degli aggiornamenti più importanti:
- crea un backup completo di file e database;
- verifica che il backup sia realmente ripristinabile;
- controlla compatibilità e requisiti dei componenti principali;
- evita di aggiornare molti elementi insieme se il sito è complesso;
- utilizza un ambiente di staging quando il progetto è critico;
- verifica lo spazio disponibile sul server.
Dopo l’aggiornamento controlla almeno:
- homepage;
- pagine principali;
- menu;
- moduli di contatto;
- area amministrativa;
- login e registrazioni;
- checkout WooCommerce, se presente;
- funzioni personalizzate importanti.
Una corretta manutenzione del sito WordPress permette di ridurre il rischio che plugin obsoleti, incompatibilità o problemi accumulati trasformino un normale aggiornamento in un’emergenza.
Se invece gli errori sono frequenti, il sito è già bloccato o non sai quali file sia sicuro modificare, puoi rivolgerti a un consulente WordPress per identificare la causa e intervenire senza procedere per tentativi.
Domande frequenti sugli errori di aggiornamento WordPress
Perché WordPress chiede le credenziali FTP per aggiornarsi?
WordPress può chiedere le credenziali FTP quando non riesce a modificare direttamente i file dell’installazione. Il comportamento può dipendere dalla configurazione del filesystem, dall’ownership dei file o dalle impostazioni del server. Prima di forzare configurazioni differenti, conviene verificare questi aspetti con il proprio hosting.
Quanto dura “Un altro aggiornamento è attualmente in corso”?
WordPress utilizza un lock temporaneo per impedire aggiornamenti contemporanei del core. In condizioni normali il blocco dura circa 15 minuti. Se il messaggio rimane più a lungo, è opportuno verificare che non sia rimasto core_updater.lock dopo un aggiornamento interrotto.
È sicuro eliminare il file .maintenance?
Sì, se l’aggiornamento è già terminato oppure si è chiaramente interrotto. Il file .maintenance viene creato temporaneamente durante gli aggiornamenti e WordPress dovrebbe rimuoverlo automaticamente al termine dell’operazione.
Cosa fare se WordPress non si apre più dopo un aggiornamento?
Controlla innanzitutto se il sito è rimasto in modalità manutenzione. Se compare un errore critico, verifica l’email dell’amministratore, la modalità di ripristino, i log PHP e il plugin o tema appena aggiornato. Se il sito gestisce funzioni importanti, valuta anche il ripristino dell’ultimo backup funzionante.
Aggiornare manualmente WordPress cancella pagine e contenuti?
No, se l’aggiornamento viene eseguito correttamente. Pagine, articoli e configurazioni principali sono memorizzati nel database, mentre media, temi e plugin sono contenuti soprattutto in wp-content. È comunque indispensabile effettuare un backup prima dell’intervento.
Perché un plugin non si aggiorna mentre gli altri sì?
Se il problema riguarda un solo plugin, la causa può essere specifica del componente: compatibilità, licenza, pacchetto di aggiornamento, file danneggiati o requisiti tecnici. Se invece nessun plugin si aggiorna, è più probabile un problema generale del filesystem, dell’hosting o della comunicazione con WordPress.org.
