Come risolvere l’errore “Briefly Unavailable for Scheduled Maintenance” in WordPress
Stai aggiornando un plugin o un tema e improvvisamente il tuo sito mostra il messaggio “Briefly Unavailable for Scheduled Maintenance. Check back in a minute”. È un errore comune in WordPress che si verifica quando un aggiornamento si blocca a metà. In questa guida ti spiego perché succede, come risolverlo in pochi secondi e come prevenirlo in futuro.
Perché compare questo errore
Quando WordPress esegue un aggiornamento (plugin, tema o core), crea automaticamente un file chiamato .maintenance nella directory principale del sito. Questo file attiva la modalità manutenzione che mostra il messaggio di errore ai visitatori, impedendo l’accesso al sito durante l’aggiornamento. Normalmente il processo dura pochi secondi e il file viene eliminato automaticamente al termine.
Il problema sorge quando l’aggiornamento si interrompe prima di completarsi. Le cause più comuni sono:
- Timeout del server: il server chiude la connessione prima che l’aggiornamento finisca, specialmente su hosting condivisi con limiti di tempo restrittivi.
- Conflitto tra plugin: un plugin interferisce con il processo di aggiornamento di un altro plugin.
- Aggiornamenti multipli simultanei: hai lanciato l’aggiornamento di molti plugin contemporaneamente e il server non regge il carico.
- Connessione interrotta: hai chiuso il browser o perso la connessione internet durante l’aggiornamento.
- Spazio su disco insufficiente: il server non ha abbastanza spazio per scaricare e decomprimere i file aggiornati.
In tutti questi casi, il file .maintenance resta nella directory e WordPress continua a mostrare la schermata di manutenzione.
Soluzione rapida: eliminare il file .maintenance
La soluzione è semplicissima: elimina il file .maintenance dalla cartella principale di WordPress. Puoi farlo in diversi modi:
Via FTP o File Manager
Collegati al tuo sito tramite un client FTP (come FileZilla) o dal File Manager del pannello di controllo del tuo hosting. Naviga nella cartella principale di WordPress (dove trovi wp-config.php). Cerca il file .maintenance e cancellalo. Nota che i file che iniziano con un punto sono nascosti per impostazione predefinita: nel tuo client FTP, attiva la visualizzazione dei file nascosti.
Via SSH
Se hai accesso SSH, il comando è immediato:
rm /var/www/html/.maintenance
Sostituisci il percorso con la directory corretta del tuo sito WordPress. Dopo aver eliminato il file, il sito tornerà immediatamente online senza bisogno di riavviare nulla.
Verificare che l’aggiornamento sia completo
Dopo aver eliminato il file .maintenance, accedi alla bacheca di WordPress e controlla la pagina Plugin o Temi. Se l’aggiornamento si è completato correttamente, vedrai la versione aggiornata. Se invece il plugin risulta ancora alla versione precedente o mostra un errore, devi rilanciare l’aggiornamento manualmente.
In alcuni casi, un aggiornamento interrotto può lasciare il plugin in uno stato corrotto, con file parzialmente sovrascritti. Se un plugin non funziona dopo un aggiornamento fallito, disattivalo e riattivalo. Se il problema persiste, elimina la cartella del plugin via FTP e reinstallalo da zero dalla bacheca di WordPress.
Come prevenire il problema in futuro
Puoi ridurre drasticamente il rischio che questo errore si ripresenti seguendo queste buone pratiche:
- Aggiorna un plugin alla volta: evita di selezionare “Aggiorna tutto” quando hai molti aggiornamenti in coda. Aggiorna i plugin uno per uno per ridurre il carico sul server.
- Aumenta i limiti PHP: nel file php.ini o wp-config.php, aumenta max_execution_time a 300 secondi per dare più tempo agli aggiornamenti.
- Non chiudere il browser: quando lanci un aggiornamento, attendi che si completi prima di navigare altrove o chiudere la finestra.
- Controlla lo spazio su disco: verifica di avere almeno 500 MB di spazio libero prima di aggiornare. Lo spazio insufficiente è una causa frequente di aggiornamenti falliti.
- Usa WP-CLI per aggiornamenti in blocco: se hai accesso SSH, aggiornare via riga di comando con wp plugin update –all è più affidabile del pannello web perché non dipende dal timeout del browser.
Cosa fare se il file .maintenance non esiste
In alcuni casi, il messaggio di manutenzione compare anche quando il file .maintenance non è presente nella directory. Questo può succedere se un plugin di manutenzione (come WP Maintenance Mode o SeedProd) è attivo e sta forzando la modalità manutenzione indipendentemente dal file. In questo caso, prova a rinominare la cartella del plugin via FTP (ad esempio rinomina wp-maintenance-mode in wp-maintenance-mode-disabled) per disattivarlo senza accedere alla bacheca.
Un altro scenario è quando il file .htaccess contiene regole di redirect che mostrano una pagina di manutenzione. Controlla il contenuto di .htaccess e cerca eventuali regole RewriteRule che redirigono tutto verso una pagina di manutenzione personalizzata.
Personalizzare la pagina di manutenzione
Il messaggio predefinito di WordPress è spartano e poco professionale. Puoi creare una pagina di manutenzione personalizzata creando un file maintenance.php (senza il punto iniziale) nella cartella wp-content/. WordPress caricherà automaticamente questo file al posto del messaggio predefinito quando la modalità manutenzione è attiva. Puoi inserirvi il logo del sito, un messaggio personalizzato e un design coerente con il tuo brand, così i visitatori vedranno una pagina curata invece del messaggio generico di WordPress.
Quando il problema è più grave
Se dopo aver eliminato il file .maintenance il sito continua a non funzionare, il problema potrebbe essere diverso. Verifica che non ci siano errori nel file error_log nella directory di WordPress. Controlla che i permessi dei file siano corretti (644 per i file, 755 per le cartelle). Se vedi una schermata bianca invece del sito, attiva la modalità debug aggiungendo define(‘WP_DEBUG’, true); nel file wp-config.php per visualizzare gli errori specifici.
Se l’aggiornamento ha corrotto i file core di WordPress, puoi reinstallare il core senza perdere contenuti. Scarica l’ultima versione di WordPress, decomprimi l’archivio e carica via FTP le cartelle wp-admin/ e wp-includes/ sovrascrivendo quelle esistenti. Non sovrascrivere wp-content/ perché contiene i tuoi temi, plugin e media. Dopo il caricamento, accedi alla bacheca e verifica che tutto funzioni correttamente.
Serve assistenza?
Se il tuo sito è bloccato in modalità manutenzione e non riesci a risolvere, o se dopo l’aggiornamento il sito presenta errori, il team di SoccorsoWP può intervenire rapidamente per ripristinare il normale funzionamento. Apri un ticket e il tuo sito tornerà online in tempi brevi.
