Pagina bianca su WordPress: come risolvere la “white screen of death”

Apri il sito e vedi solo una pagina bianca, senza testo e senza un messaggio di errore. La pagina bianca su WordPress è frustrante proprio perché non dà indizi. Dalla versione 5.2 WordPress mostra più spesso il messaggio “Si è verificato un errore critico” al posto del bianco, ma la schermata vuota può ancora comparire, sul sito pubblico, solo in bacheca o su singole pagine. Le cause sono poche e si controllano una alla volta, con ordine, senza peggiorare le cose.

Cos’è la “white screen of death” di WordPress?

È una pagina completamente vuota che compare quando il codice PHP del sito si interrompe prima di produrre qualsiasi contenuto e gli errori non vengono mostrati a schermo. Il server risponde, ma non ha nulla da mandare al browser.

Prima di WordPress 5.2 era il sintomo classico di qualsiasi errore fatale. Oggi WordPress intercetta gran parte di questi errori e mostra un messaggio con le istruzioni, che trattiamo nella guida all’errore critico di WordPress. La pagina bianca resta possibile quando:

• la protezione dagli errori fatali è disattivata nel file di configurazione;
• l’errore avviene in un punto in cui WordPress non riesce a gestirlo;
• la memoria si esaurisce in un modo che impedisce anche di mostrare il messaggio;
• una cache o una CDN (una rete che distribuisce copie del sito) ha salvato una versione vuota della pagina;
• il tema o un plugin generano una pagina vuota senza un vero errore.

La pagina è bianca ovunque o solo in alcune parti?

Capire dove compare la pagina bianca restringe subito il campo delle cause. È il primo controllo da fare, e richiede due minuti.

Per l’ultimo caso basta un test: apri il sito in una finestra di navigazione privata o da un altro dispositivo, come lo smartphone con i dati mobili. Se lì il sito funziona, il problema è nel tuo browser e si risolve svuotando cache e cookie.

Qual è la prima cosa da fare?

La prima cosa è fare un backup di file e database, poi ricordare cosa è cambiato di recente. Nella grande maggioranza dei casi la pagina bianca compare subito dopo un aggiornamento, l’installazione di un plugin o una modifica al tema.

Il backup si fa dal pannello dell’hosting oppure scaricando i file via FTP ed esportando il database da phpMyAdmin; tutti i metodi sono spiegati nella guida ai backup di WordPress. Controlla anche la casella email dell’amministratore: se WordPress ha rilevato l’errore, potresti aver ricevuto un’email con un link per entrare in modalità di recupero e il nome del componente che ha causato il blocco.

Come si fa a vedere l’errore nascosto dietro la pagina bianca?

Si attiva il registro degli errori di WordPress, che salva il messaggio completo nel file wp-content/debug.log. Il messaggio indica il file responsabile, e dal percorso capisci se è un plugin, il tema o altro.

1. Collegati via FTP o dal file manager dell’hosting e apri wp-config.php nella cartella principale.
2. Prima della riga che invita a smettere di modificare, aggiungi le righe indicate qui sotto.
3. Ricarica la pagina bianca e poi apri wp-content/debug.log.
4. Cerca le righe con “Fatal error” e guarda il percorso: wp-content/plugins/... o wp-content/themes/....

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Così gli errori vanno nel file e non vengono mostrati ai visitatori. Finita la diagnosi, riporta WP_DEBUG su false e cancella il file di log: la documentazione di WordPress sconsiglia il debug sui siti in produzione. Se il file resta vuoto, cerca il log degli errori PHP nel pannello dell’hosting.

Come si escludono plugin e tema?

Si escludono disattivandoli via FTP, rinominando le loro cartelle: se la pagina bianca sparisce, hai trovato il responsabile. Non serve accedere alla bacheca.

Plugin

1. In wp-content/ rinomina la cartella plugins in plugins-off.
2. Ricarica il sito. Se torna visibile, la causa è un plugin.
3. Rinomina la cartella di nuovo in plugins, entra in bacheca e riattiva i plugin uno alla volta, controllando il sito dopo ciascuno.

Se il log ti ha già indicato un plugin preciso, rinomina solo la sua cartella.

Tema

1. Controlla che in wp-content/themes/ ci sia un tema predefinito, per esempio Twenty Twenty-Five.
2. Rinomina la cartella del tema attivo: WordPress passerà al tema predefinito.
3. Se il sito torna visibile, il problema è nel tema o nel child theme, spesso in una modifica recente a functions.php.

Una volta trovato il responsabile, cerca un aggiornamento che corregga il problema o torna alla versione precedente dal backup. Per ridurre il rischio in futuro, leggi come aggiornare WordPress senza rompere il sito.

E se il problema è la memoria?

Se nel log trovi “Allowed memory size … exhausted”, WordPress ha esaurito la memoria concessa da PHP. Puoi alzare il limite in wp-config.php, ma solo fino al massimo permesso dall’hosting.

define( 'WP_MEMORY_LIMIT', '256M' );

Il valore predefinito di WordPress, secondo la documentazione di wp-config.php, è 40 MB per un sito singolo. Se il limite del server è più basso di quello che imposti, devi aumentarlo dal pannello dell’hosting. E se un sito semplice finisce la memoria, conviene capire quale plugin la consuma, invece di limitarsi ad alzare il tetto.

La pagina bianca può dipendere dalla cache?

Sì. Se un plugin di cache, la cache del server o una CDN hanno salvato una pagina vuota durante un errore, continuano a mostrarla anche dopo che il problema è stato risolto. Per questo, dopo ogni correzione, va svuotata la cache a tutti i livelli.

1. Svuota la cache del plugin (dalla bacheca, oppure cancellando il contenuto di wp-content/cache/ via FTP se non entri).
2. Svuota la cache del server dal pannello dell’hosting, se presente.
3. Svuota la cache della CDN, per esempio Cloudflare, se la usi.
4. Ricontrolla il sito in navigazione privata.

Quali altre cause sono meno frequenti?

Se plugin, tema, memoria e cache sono esclusi, restano cause più rare che richiedono un po’ più di esperienza.

• La versione PHP cambiata dall’hosting, con plugin o tema non compatibili. Controlla nel pannello e leggi la guida su come aggiornare la versione PHP di WordPress.
• Un aggiornamento interrotto. Se nella cartella principale c’è un file .maintenance rimasto dopo un aggiornamento fallito, il sito può restare bloccato in manutenzione; eliminarlo di solito sblocca la situazione, ma poi va completato l’aggiornamento.
• File di WordPress danneggiati: in questo caso si ricaricano le cartelle wp-admin e wp-includes della stessa versione, senza toccare wp-content e wp-config.php.
• Lo spazio disco esaurito sull’hosting, che può impedire di scrivere file temporanei e sessioni.
• Codice malevolo che rompe il sito. Se trovi file sconosciuti o modificati, segui la guida su cosa fare se il sito è stato hackerato.

Se dopo questi passaggi il sito resta bianco, o se è un sito da cui dipende il tuo lavoro e non puoi permetterti tentativi, è il momento di affidarsi a un tecnico.

Domande frequenti

Cosa fare se la pagina bianca compare solo in wp-admin?

Se il sito pubblico funziona e solo la bacheca è bianca, la causa più probabile è un plugin che lavora nell’amministrazione o la memoria PHP disponibile in bacheca. Controlla l’email dell’amministratore: dalla versione 5.2 WordPress può inviare un link alla modalità di recupero, che mette in pausa il plugin o il tema difettoso solo per la tua sessione. Se l’email non arriva, disattiva i plugin via FTP come spiegato sopra; se invece il problema è il login, leggi cosa fare quando non riesci ad accedere a wp-admin.

La pagina bianca significa che ho perso il sito?

Quasi mai. Nella grande maggioranza dei casi i contenuti sono intatti nel database e il problema è un singolo componente che blocca il caricamento. Individuato e disattivato quello, il sito torna com’era.

Perché la bacheca funziona ma il sito è bianco?

Di solito la causa è il tema, il page builder o la cache, che intervengono solo sulle pagine pubbliche. Prova a svuotare le cache e poi a passare temporaneamente a un tema predefinito.

Che differenza c’è tra pagina bianca ed errore critico?

Spesso la causa è la stessa, un errore PHP fatale. Con l’errore critico WordPress ha intercettato il problema e mostra un messaggio; con la pagina bianca non è riuscito a farlo, quindi devi leggere il log per capire cosa è successo.