{"id":25683,"date":"2026-03-13T10:00:00","date_gmt":"2026-03-13T09:00:00","guid":{"rendered":"https:\/\/soccorsowp.it\/blog\/?p=25683"},"modified":"2026-06-08T10:04:25","modified_gmt":"2026-06-08T10:04:25","slug":"errore-maintenance-mode-wordpress-soluzione","status":"publish","type":"post","link":"https:\/\/soccorsowp.it\/blog\/errore-maintenance-mode-wordpress-soluzione\/","title":{"rendered":"Errore &#8220;Briefly Unavailable&#8221; WordPress: come risolverlo"},"content":{"rendered":"<h2>Errore &quot;Briefly Unavailable&quot; WordPress: come risolverlo<\/h2>\n<p>Stavi aggiornando un plugin o il core di <a href=\"https:\/\/soccorsowp.it\/blog\/blocco-di-contenuti-opt-in-per-wordpress\/\">WordPress<\/a> e improvvisamente il sito mostra il messaggio <strong>&#8220;Brevemente non disponibile per manutenzione programmata. Riprova fra un minuto&#8221;<\/strong>? Questo errore \u00e8 noto come <strong>modalit\u00e0 manutenzione bloccata<\/strong> 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.<\/p>\n<h2>Perch\u00e9 WordPress entra in modalit\u00e0 manutenzione<\/h2>\n<p>Quando esegui un aggiornamento dalla dashboard (plugin, tema o core), WordPress crea automaticamente un file chiamato <span style=\"font-family: monospace\">.maintenance<\/span> nella cartella principale del sito. Questo file mette il sito in <strong>modalit\u00e0 manutenzione<\/strong> temporanea, mostrando il messaggio ai visitatori mentre l&#8217;aggiornamento \u00e8 in corso. Al termine dell&#8217;aggiornamento, WordPress elimina automaticamente il file e il sito torna online.<\/p>\n<p>Il problema si verifica quando il processo di aggiornamento <strong>si interrompe<\/strong> prima di poter eliminare il file .maintenance. Le cause pi\u00f9 comuni dell&#8217;interruzione sono:<\/p>\n<ul>\n<li><strong>Timeout PHP:<\/strong> l&#8217;aggiornamento richiede pi\u00f9 tempo del <span style=\"font-family: monospace\">max_execution_time<\/span> configurato sul server e PHP interrompe lo script.<\/li>\n<li><strong>Errore di memoria:<\/strong> l&#8217;aggiornamento supera il <span style=\"font-family: monospace\">memory_limit<\/span> PHP e lo script viene terminato.<\/li>\n<li><strong>Connessione interrotta:<\/strong> hai chiuso il browser, la connessione internet si \u00e8 interrotta o il server ha avuto un problema di rete durante l&#8217;aggiornamento.<\/li>\n<li><strong>Aggiornamento multiplo simultaneo:<\/strong> hai avviato l&#8217;aggiornamento di molti plugin contemporaneamente e il server non \u00e8 riuscito a gestirli tutti.<\/li>\n<li><strong>Conflitto durante l&#8217;aggiornamento:<\/strong> un plugin in fase di aggiornamento ha causato un errore fatale che ha interrotto l&#8217;intero processo.<\/li>\n<\/ul>\n<h2>La soluzione rapida: eliminare il file .maintenance<\/h2>\n<p>Nella grande maggioranza dei casi, la soluzione \u00e8 semplicissima: <strong>elimina il file .maintenance<\/strong> dalla cartella principale di WordPress.<\/p>\n<ol>\n<li>Collegati al server via <strong>FTP<\/strong> (con FileZilla o un altro client) oppure usa il <strong>File Manager<\/strong> del tuo pannello hosting (Plesk, cPanel).<\/li>\n<li>Naviga nella cartella principale di WordPress (la stessa che contiene <span style=\"font-family: monospace\">wp-config.php<\/span>).<\/li>\n<li>Cerca il file <span style=\"font-family: monospace\">.maintenance<\/span>. <strong>Nota:<\/strong> il file inizia con un punto, quindi \u00e8 un file nascosto. Assicurati che il tuo client FTP o file manager mostri i file nascosti (in FileZilla: Server \u2192 Forza la visualizzazione dei file nascosti).<\/li>\n<li><strong>Elimina il file<\/strong> <span style=\"font-family: monospace\">.maintenance<\/span>.<\/li>\n<li>Ricarica il sito nel browser: dovrebbe tornare online immediatamente.<\/li>\n<\/ol>\n<p>Se usi SSH, il comando \u00e8 ancora pi\u00f9 rapido:<\/p>\n<pre>rm \/percorso\/wordpress\/.maintenance<\/pre>\n<h2>Verificare che l&#8217;aggiornamento sia completato<\/h2>\n<p>Eliminare il file .maintenance riporta il sito online, ma l&#8217;aggiornamento che ha causato il problema potrebbe essere <strong>rimasto a met\u00e0<\/strong>. Dopo aver risolto l&#8217;errore, verifica lo stato degli aggiornamenti:<\/p>\n<ol>\n<li>Accedi alla dashboard di WordPress (<span style=\"font-family: monospace\">tuosito.it\/wp-admin<\/span>).<\/li>\n<li>Vai su <span style=\"font-family: monospace\">Dashboard \u2192 Aggiornamenti<\/span> e controlla se ci sono aggiornamenti in sospeso.<\/li>\n<li>Vai su <span style=\"font-family: monospace\">Plugin \u2192 Plugin installati<\/span> e verifica che tutti i plugin siano attivi e funzionanti. Se un plugin \u00e8 stato disattivato durante l&#8217;aggiornamento interrotto, riattivalo.<\/li>\n<li>Se l&#8217;aggiornamento \u00e8 ancora necessario, <strong>rieseguilo<\/strong> dalla dashboard. Questa volta, evita di chiudere il browser o navigare durante l&#8217;aggiornamento.<\/li>\n<\/ol>\n<h2>Prevenire il problema in futuro<\/h2>\n<p>Per evitare che il sito resti bloccato in modalit\u00e0 manutenzione in futuro:<\/p>\n<ul>\n<li><strong>Aggiorna i plugin uno alla volta:<\/strong> anzich\u00e9 selezionare &#8220;Aggiorna tutto&#8221;, aggiorna i plugin singolarmente. Se un aggiornamento fallisce, il danno \u00e8 limitato a un singolo plugin.<\/li>\n<li><strong>Non chiudere il browser durante gli aggiornamenti:<\/strong> resta sulla pagina finch\u00e9 WordPress non conferma il completamento dell&#8217;aggiornamento.<\/li>\n<li><strong>Aumenta il timeout PHP:<\/strong> se gli aggiornamenti falliscono spesso per timeout, aumenta <span style=\"font-family: monospace\">max_execution_time<\/span> a 300 secondi dal pannello hosting.<\/li>\n<li><strong>Aumenta la memoria PHP:<\/strong> imposta <span style=\"font-family: monospace\">memory_limit<\/span> a 256M per evitare errori di memoria durante aggiornamenti di plugin pesanti.<\/li>\n<li><strong>Usa WP-CLI per gli aggiornamenti:<\/strong> se hai accesso SSH, <span style=\"font-family: monospace\">wp plugin update &#8211;all<\/span> aggiorna tutti i plugin da riga di comando senza i limiti del browser e con un timeout molto pi\u00f9 generoso.<\/li>\n<li><strong>Fai un backup prima di aggiornare:<\/strong> in caso di problemi, puoi ripristinare il backup e riprovare con calma.<\/li>\n<\/ul>\n<h2>Il sito mostra ancora l&#8217;errore dopo aver eliminato .maintenance<\/h2>\n<p>Se il messaggio di manutenzione persiste anche dopo aver eliminato il file .maintenance, il problema potrebbe essere diverso:<\/p>\n<ul>\n<li><strong>Cache del browser:<\/strong> svuota la cache del browser o prova con una finestra in incognito.<\/li>\n<li><strong>Cache del server:<\/strong> se usi un plugin di cache o <a href=\"https:\/\/soccorsowp.it\/blog\/5-consigli-per-velocizzare-il-tuo-sito-web-wordpress-da-subito\/\">Cloudflare<\/a>, svuota la cache a livello server.<\/li>\n<li><strong>Pagina di manutenzione personalizzata:<\/strong> 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.<\/li>\n<li><strong>Errore PHP sottostante:<\/strong> l&#8217;aggiornamento interrotto potrebbe aver lasciato un plugin in uno stato corrotto. Attiva il debug in wp-config.php per vedere l&#8217;errore specifico, poi disattiva il plugin problematico rinominando la sua cartella via FTP.<\/li>\n<\/ul>\n<h2>Come funziona il file .maintenance internamente<\/h2>\n<p>Per chi \u00e8 curioso, il file <span style=\"font-family: monospace\">.maintenance<\/span> \u00e8 un semplice file PHP che contiene una variabile con il timestamp di quando \u00e8 stata attivata la modalit\u00e0 manutenzione:<\/p>\n<pre>&lt;?php $upgrading = 1709294400; ?&gt;<\/pre>\n<p>WordPress controlla la presenza di questo file a ogni richiesta. Se il file esiste e il timestamp \u00e8 recente (meno di 10 minuti fa), mostra la pagina di manutenzione. Se il file esiste ma il timestamp \u00e8 pi\u00f9 vecchio di 10 minuti, WordPress lo ignora e mostra il sito normalmente. Questo \u00e8 un meccanismo di sicurezza: anche se il file non viene eliminato, il sito dovrebbe tornare accessibile dopo 10 minuti dall&#8217;ultimo tentativo di aggiornamento.<\/p>\n<p>Se il sito resta bloccato per pi\u00f9 di 10 minuti, il file \u00e8 stato probabilmente ricreato da un tentativo di aggiornamento successivo o il timestamp \u00e8 stato aggiornato. In questo caso, l&#8217;eliminazione manuale \u00e8 l&#8217;unica soluzione.<\/p>\n<h2>Personalizzare la pagina di manutenzione<\/h2>\n<p>Il messaggio predefinito di WordPress \u00e8 minimale e poco professionale. Se vuoi mostrare una pagina di manutenzione personalizzata durante gli aggiornamenti, puoi creare un file <span style=\"font-family: monospace\">maintenance.php<\/span> nella cartella <span style=\"font-family: monospace\">wp-content<\/span>. WordPress lo user\u00e0 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&#8217;esperienza migliore ai visitatori che arrivano durante un aggiornamento.<\/p>\n<h2>L&#8217;aggiornamento ha rotto il sito?<\/h2>\n<p>Se dopo l&#8217;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 \u00e8 la via pi\u00f9 rapida e sicura.<\/p>\n<p>Se non hai un backup o non riesci a risolvere il problema, il team di <strong><a href=\"https:\/\/soccorsowp.it\/blog\/i-migliori-plugin-woocommerce-per-dominare-il-black-friday\/\">SoccorsoWP<\/a><\/strong> pu\u00f2 diagnosticare il danno causato dall&#8217;aggiornamento interrotto, ripristinare i file corrotti e riportare il sito online. <a href=\"https:\/\/soccorsowp.it\/ticket\/\">Apri un ticket<\/a> e torna operativo rapidamente.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Errore &quot;Briefly Unavailable&quot; WordPress: come risolverlo Stavi aggiornando un plugin o il core di WordPress e improvvisamente il sito mostra il messaggio &#8220;Brevemente non disponibile&#8230;<\/p>\n","protected":false},"author":1,"featured_media":25684,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"Errore \"Briefly Unavailable\" WordPress: come risolverlo","_seopress_titles_desc":"Come risolvere l'errore \"Briefly Unavailable for Scheduled Maintenance\" in WordPress: eliminare .maintenance, verificare aggiornamenti e prevenzione.","_seopress_robots_index":"","footnotes":""},"categories":[1424],"tags":[],"class_list":{"0":"post-25683","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-bug-e-vulnerabilita"},"_links":{"self":[{"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/posts\/25683","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/comments?post=25683"}],"version-history":[{"count":3,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/posts\/25683\/revisions"}],"predecessor-version":[{"id":27356,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/posts\/25683\/revisions\/27356"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/media\/25684"}],"wp:attachment":[{"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/media?parent=25683"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/categories?post=25683"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/soccorsowp.it\/blog\/wp-json\/wp\/v2\/tags?post=25683"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}