Come risolvere l’errore “Briefly Unavailable for Scheduled Maintenance” in WordPress

Stavi aggiornando un plugin o il core di WordPress e improvvisamente il sito mostra il messaggio “Brevemente non disponibile per manutenzione programmata. Riprova fra un minuto”? Questo errore è noto come modalità manutenzione bloccata e accade quando WordPress non riesce a completare un aggiornamento correttamente. Nella maggior parte dei casi si risolve in pochi secondi, ma ecco come risolvere quando il sito resta bloccato.

Perché WordPress entra in modalità manutenzione

Quando esegui un aggiornamento dalla dashboard (plugin, tema o core), WordPress crea automaticamente un file chiamato .maintenance nella cartella principale del sito. Questo file mette il sito in modalità manutenzione temporanea, mostrando il messaggio ai visitatori mentre l’aggiornamento è in corso. Al termine dell’aggiornamento, WordPress elimina automaticamente il file e il sito torna online.

Il problema si verifica quando il processo di aggiornamento si interrompe prima di poter eliminare il file .maintenance. Le cause più comuni dell’interruzione sono:

• Timeout PHP: l’aggiornamento richiede più tempo del max_execution_time configurato sul server e PHP interrompe lo script.
• Errore di memoria: l’aggiornamento supera il memory_limit PHP e lo script viene terminato.
• Connessione interrotta: hai chiuso il browser, la connessione internet si è interrotta o il server ha avuto un problema di rete durante l’aggiornamento.
• Aggiornamento multiplo simultaneo: hai avviato l’aggiornamento di molti plugin contemporaneamente e il server non è riuscito a gestirli tutti.
• Conflitto durante l’aggiornamento: un plugin in fase di aggiornamento ha causato un errore fatale che ha interrotto l’intero processo.

La soluzione rapida: eliminare il file .maintenance

Nella grande maggioranza dei casi, la soluzione è semplicissima: elimina il file .maintenance dalla cartella principale di WordPress.

1. Collegati al server via FTP (con FileZilla o un altro client) oppure usa il File Manager del tuo pannello hosting (Plesk, cPanel).
2. Naviga nella cartella principale di WordPress (la stessa che contiene wp-config.php).
3. Cerca il file .maintenance. Nota: il file inizia con un punto, quindi è un file nascosto. Assicurati che il tuo client FTP o file manager mostri i file nascosti (in FileZilla: Server → Forza la visualizzazione dei file nascosti).
4. Elimina il file .maintenance.
5. Ricarica il sito nel browser: dovrebbe tornare online immediatamente.

Se usi SSH, il comando è ancora più rapido:

rm /percorso/wordpress/.maintenance

Verificare che l’aggiornamento sia completato

Eliminare il file .maintenance riporta il sito online, ma l’aggiornamento che ha causato il problema potrebbe essere rimasto a metà. Dopo aver risolto l’errore, verifica lo stato degli aggiornamenti:

1. Accedi alla dashboard di WordPress (tuosito.it/wp-admin).
2. Vai su Dashboard → Aggiornamenti e controlla se ci sono aggiornamenti in sospeso.
3. Vai su Plugin → Plugin installati e verifica che tutti i plugin siano attivi e funzionanti. Se un plugin è stato disattivato durante l’aggiornamento interrotto, riattivalo.
4. Se l’aggiornamento è ancora necessario, rieseguilo dalla dashboard. Questa volta, evita di chiudere il browser o navigare durante l’aggiornamento.

Prevenire il problema in futuro

Per evitare che il sito resti bloccato in modalità manutenzione in futuro:

• Aggiorna i plugin uno alla volta: anziché selezionare “Aggiorna tutto”, aggiorna i plugin singolarmente. Se un aggiornamento fallisce, il danno è limitato a un singolo plugin.
• Non chiudere il browser durante gli aggiornamenti: resta sulla pagina finché WordPress non conferma il completamento dell’aggiornamento.
• Aumenta il timeout PHP: se gli aggiornamenti falliscono spesso per timeout, aumenta max_execution_time a 300 secondi dal pannello hosting.
• Aumenta la memoria PHP: imposta memory_limit a 256M per evitare errori di memoria durante aggiornamenti di plugin pesanti.
• Usa WP-CLI per gli aggiornamenti: se hai accesso SSH, wp plugin update –all aggiorna tutti i plugin da riga di comando senza i limiti del browser e con un timeout molto più generoso.
• Fai un backup prima di aggiornare: in caso di problemi, puoi ripristinare il backup e riprovare con calma.

Il sito mostra ancora l’errore dopo aver eliminato .maintenance

Se il messaggio di manutenzione persiste anche dopo aver eliminato il file .maintenance, il problema potrebbe essere diverso:

• Cache del browser: svuota la cache del browser o prova con una finestra in incognito.
• Cache del server: se usi un plugin di cache o Cloudflare, svuota la cache a livello server.
• Pagina di manutenzione personalizzata: alcuni plugin di manutenzione (SeedProd, WP Maintenance Mode) creano una pagina di manutenzione indipendente dal file .maintenance. Verifica se hai un plugin di manutenzione attivo e disattivalo dal pannello o rinominando la sua cartella via FTP.
• Errore PHP sottostante: l’aggiornamento interrotto potrebbe aver lasciato un plugin in uno stato corrotto. Attiva il debug in wp-config.php per vedere l’errore specifico, poi disattiva il plugin problematico rinominando la sua cartella via FTP.

Come funziona il file .maintenance internamente

Per chi è curioso, il file .maintenance è un semplice file PHP che contiene una variabile con il timestamp di quando è stata attivata la modalità manutenzione:

<?php $upgrading = 1709294400; ?>

WordPress controlla la presenza di questo file a ogni richiesta. Se il file esiste e il timestamp è recente (meno di 10 minuti fa), mostra la pagina di manutenzione. Se il file esiste ma il timestamp è più vecchio di 10 minuti, WordPress lo ignora e mostra il sito normalmente. Questo è un meccanismo di sicurezza: anche se il file non viene eliminato, il sito dovrebbe tornare accessibile dopo 10 minuti dall’ultimo tentativo di aggiornamento.

Se il sito resta bloccato per più di 10 minuti, il file è stato probabilmente ricreato da un tentativo di aggiornamento successivo o il timestamp è stato aggiornato. In questo caso, l’eliminazione manuale è l’unica soluzione.

Personalizzare la pagina di manutenzione

Il messaggio predefinito di WordPress è minimale e poco professionale. Se vuoi mostrare una pagina di manutenzione personalizzata durante gli aggiornamenti, puoi creare un file maintenance.php nella cartella wp-content. WordPress lo userà automaticamente al posto del messaggio predefinito. Puoi inserire il logo della tua azienda, un messaggio personalizzato e un design coerente con il tuo brand, offrendo un’esperienza migliore ai visitatori che arrivano durante un aggiornamento.

L’aggiornamento ha rotto il sito?

Se dopo l’aggiornamento interrotto il sito mostra errori anche con il file .maintenance eliminato, potrebbe essere necessario intervenire manualmente sui file del plugin o ripristinare da un backup. Se hai un backup recente, il ripristino è la via più rapida e sicura.

Se non hai un backup o non riesci a risolvere il problema, il team di SoccorsoWP può diagnosticare il danno causato dall’aggiornamento interrotto, ripristinare i file corrotti e riportare il sito online. Apri un ticket e torna operativo rapidamente.