Aggiornamento fallito: sito bloccato in manutenzione
"Brevemente non disponibile per manutenzione programmata" e resta così? La colpa è di un solo file, e si rimuove in un minuto.
Prima di ogni aggiornamento WordPress crea un file chiamato .maintenance nella directory principale e lo rimuove al termine. Se l'aggiornamento si interrompe – un timeout, una scheda del browser chiusa, un errore durante l'estrazione – il file resta e con esso l'avviso di manutenzione. Elimina .maintenance via FTP o dal file manager e il sito torna subito.
Eliminare il file – poi controllare
Il file .maintenance si trova nella stessa cartella di wp-config.php. Inizia con un punto, e molti programmi FTP nascondono questi file – in FileZilla attiva "Server → Forza visualizzazione file nascosti".
Dopo averlo eliminato il sito è raggiungibile, ma l'aggiornamento non è finito. Accedi e controlla in Bacheca → Aggiornamenti cosa manca. Spesso è esattamente un plugin rimasto a metà; un secondo tentativo lo porta a termine.
Perché gli aggiornamenti si interrompono
Il motivo più comune è un timeout: il limite di tempo di PHP scatta prima che un plugin grande sia estratto. Sull'hosting condiviso è spesso di 30 secondi. Un secondo tentativo di solito riesce perché parte del lavoro è già fatta.
Seguono i problemi di permessi – il server web non può scrivere in wp-content – e lo spazio su disco insufficiente. L'hoster segnala entrambi nel log. E infine: una scheda del browser chiusa a metà aggiornamento. WordPress esegue gli aggiornamenti nel browser, non in background.
Perché non succeda di nuovo
Un backup prima di ogni aggiornamento importante, e non tutti gli aggiornamenti insieme: prima il core, poi i plugin in piccoli gruppi. Così è chiaro quale pacchetto ha causato il problema.
Gli aggiornamenti automatici per le release di sicurezza restano comunque giusti – sono piccoli e raramente incontrano un limite di tempo. Per i grandi aggiornamenti funzionali vale la pena avere un'installazione di prova, se il sito genera fatturato.
Fonti e documentazione
Domande frequenti
Non trovo nessun file chiamato .maintenance.
Allora il tuo programma nasconde i file il cui nome inizia con un punto. In FileZilla usa "Server → Forza visualizzazione file nascosti"; la maggior parte dei file manager degli hoster ha un interruttore corrispondente nelle impostazioni. Se davvero non c'è, l'avviso di manutenzione viene da altro, per esempio da un plugin di manutenzione.
Il sito è davvero a posto dopo l'eliminazione?
Raggiungibile sì, completamente aggiornato non necessariamente. Dopo controlla in Bacheca → Aggiornamenti se manca qualcosa e clicca alcune pagine e l'area di amministrazione. Un plugin estratto a metà può altrimenti farsi notare giorni dopo.
Altre guide
"Errore nello stabilire una connessione al database"
Leggi l'articolo →WordPress mostra una schermata bianca – cosa fare?
Leggi l'articolo →Hai un progetto in mente?
Mettiti in contatto
WP Bitty
Assistente WordPress
Assistente IA — può commettere errori. Non giuridicamente vincolante.