Come risolvere l’errore “Site Stuck in Maintenance Mode” in WordPress

Cosa significa “Site Stuck in Maintenance Mode”

Il messaggio di manutenzione di WordPress

Quando aggiorni WordPress, un plugin o un tema, il sistema attiva automaticamente la modalità manutenzione per evitare che i visitatori visualizzino pagine instabili durante il processo. In quel momento, chi visita il sito vede un semplice messaggio:

“Briefly unavailable for scheduled maintenance. Check back in a minute.”

Di norma, questo messaggio scompare da solo appena l’aggiornamento finisce. Ma se qualcosa va storto — ad esempio un’interruzione di connessione o un errore nel codice — il sito resta bloccato in modalità manutenzione.

Perché il sito resta bloccato anche dopo l’aggiornamento

Il blocco è causato da un piccolo file temporaneo chiamato .maintenance, che viene creato nella root del tuo sito ogni volta che parte un aggiornamento. Quando tutto va bene, questo file viene eliminato automaticamente.

Ma se:

• L’aggiornamento viene interrotto,
• Il server va in timeout,
• C’è un conflitto con un plugin,

…quel file resta lì e continua a dire a WordPress: “Ehi, siamo ancora in manutenzione!”. Il risultato? Nessuno può accedere al sito, nemmeno tu.

Cause più comuni del problema

Aggiornamenti interrotti di plugin o temi

Uno dei motivi più frequenti per cui un sito WordPress resta bloccato in modalità manutenzione è l’interruzione di un aggiornamento. Questo può succedere per diversi motivi:

• Hai chiuso il browser prima che l’aggiornamento finisse
• La connessione internet si è interrotta
• Il server ha impiegato troppo tempo e ha generato un timeout

In questi casi, WordPress non riesce a completare il processo e non rimuove il file .maintenance.

File .maintenance non rimosso automaticamente

Durante ogni aggiornamento, WordPress crea un file chiamato .maintenance nella directory principale del sito. È un file temporaneo che segnala al sistema che è in corso una manutenzione.

Quando tutto fila liscio, WordPress lo elimina automaticamente al termine dell’operazione. Ma se qualcosa lo blocca — anche solo per un secondo — quel file resta lì e impedisce l’accesso al sito, mostrando sempre il messaggio di “maintenance mode”.

Timeout del server o errori PHP durante l’aggiornamento

Un’altra causa comune è un errore PHP o un timeout del server durante l’aggiornamento. Ad esempio:

• Un plugin ha un bug
• Il server ha risorse limitate (RAM, CPU)
• Stai aggiornando troppi elementi contemporaneamente

Risultato? Il processo viene interrotto prima della sua conclusione e il sito resta bloccato.

Come uscire dalla modalità manutenzione passo dopo passo

Accedere via FTP o File Manager del tuo hosting

Per risolvere questo problema, devi accedere ai file del tuo sito WordPress. Puoi farlo in due modi:

• Via FTP, usando un client come FileZilla
• Dal File Manager del pannello di controllo del tuo hosting (come cPanel, Plesk o DirectAdmin)

Una volta entrato nella root del sito (public_html o htdocs), cerca un file chiamato:

.maintenance

.maintenance

Cancellare il file .maintenance nella root del sito

Una volta trovato il file .maintenance, cancellalo.

📌 Attenzione: elimina solo quel file, non toccare gli altri.

Subito dopo:

• Ricarica il tuo sito WordPress nel browser
• Il messaggio “Briefly unavailable for scheduled maintenance” dovrebbe scomparire
• Il sito tornerà visibile e funzionante come prima

Pulire la cache del browser e/o del sito

A volte, anche dopo la rimozione del file, potresti vedere ancora il messaggio di manutenzione. Questo succede perché il browser o un plugin di caching sta ancora mostrando una versione vecchia della pagina.

Ecco cosa fare:

• Cancella la cache del browser (Ctrl + F5 o Cmd + Shift + R)
• Se usi un plugin di cache (come WP Rocket, W3 Total Cache, LiteSpeed), svuota anche quella
• Se hai un sistema di cache lato server (es. Cloudflare), svuotalo temporaneamente

Come prevenire il problema in futuro

Aspettare sempre la fine degli aggiornamenti

Sembra banale, ma è la regola d’oro: non chiudere la pagina e non ricaricare il browser durante un aggiornamento di WordPress, plugin o temi. Anche se sembra che il caricamento si sia bloccato, lascia che il sistema faccia il suo lavoro.

📌 Un aggiornamento interrotto è la causa principale della modalità manutenzione bloccata.

Fare backup prima di aggiornare plugin o temi

Prima di ogni aggiornamento, anche piccolo, è buona pratica fare un backup completo del sito, inclusi:

• File (tema, plugin, media)
• Database (contenuti e impostazioni)

Puoi usare plugin come UpdraftPlus, All-in-One WP Migration o le funzioni di backup automatico offerte dal tuo hosting.

✅ In caso di problemi, puoi ripristinare tutto in un click.

Aggiornare uno alla volta, non in blocco

Evita di selezionare tutti i plugin e aggiornare “in massa”. Aggiorna uno per volta, specialmente se:

• Hai molti plugin installati
• Usi temi personalizzati
• Il sito è in produzione (quindi online e attivo con utenti)

📌 Questo ti permette di isolare eventuali problemi e risolverli più facilmente.