Il sito presenta una schermata bianca.
Come posso risolvere?

Una schermata completamente bianca al posto del tuo sito WordPress può sembrare uno dei problemi peggiori possibili.

Nella maggior parte dei casi, però, il sito non è “sparito”: WordPress o PHP hanno semplicemente incontrato un errore che impedisce alla pagina di essere generata correttamente.

Questo problema è comunemente chiamato White Screen of Death, spesso abbreviato in WSoD.

Vediamo quali sono le cause più comuni, come individuare quella responsabile e quali controlli effettuare prima di intervenire in modo più invasivo.

Cos’è la White Screen of Death di WordPress?

La White Screen of Death si verifica quando WordPress non riesce a completare correttamente il caricamento di una pagina e il browser mostra una schermata vuota, senza contenuti e talvolta senza alcun messaggio di errore.

Il problema può interessare:

• tutto il sito;
• solamente alcune pagine;
• l’area di amministrazione;
• il frontend mentre /wp-admin continua a funzionare;
• una specifica funzionalità del sito.

PHP e database possono entrambi essere coinvolti in problemi che si manifestano con una pagina bianca. Tra le cause documentate da WordPress ci sono anche incompatibilità legate a plugin e temi.

Prima di iniziare a modificare file o impostazioni, è quindi importante capire dove si manifesta l’errore e cosa è cambiato immediatamente prima che comparisse.

Le cause più comuni della schermata bianca

Non esiste una sola causa della WSoD. Alcuni problemi, però, ricorrono molto più spesso di altri.

Plugin incompatibile o difettoso

Un plugin può generare un errore PHP dopo:

• un aggiornamento;
• un cambio di versione di PHP;
• l’installazione di un altro plugin;
• una modifica alla configurazione del sito;
• un conflitto con il tema.

Se la schermata bianca è comparsa subito dopo l’aggiornamento o l’attivazione di un plugin, questo è uno dei primi elementi da verificare.

Problemi con il tema

Anche il tema attivo esegue codice PHP e può quindi provocare un errore fatale.

Il problema può comparire dopo un aggiornamento del tema, una modifica al file functions.php, l’inserimento di codice personalizzato oppure in seguito a un cambiamento nella versione di PHP utilizzata dal server.

Errori nel codice PHP

Una semplice modifica al codice può essere sufficiente a rendere una pagina irraggiungibile.

Un errore di sintassi, una funzione non disponibile, una classe mancante o una chiamata incompatibile con la versione di PHP in uso possono interrompere l’esecuzione prima che WordPress riesca a generare la pagina.

Memoria PHP insufficiente

Plugin particolarmente pesanti, importazioni, elaborazioni di immagini o operazioni complesse possono richiedere più memoria di quella disponibile.

Quando PHP raggiunge il limite assegnato, l’esecuzione può terminare con un errore fatale.

Aumentare indiscriminatamente il limite di memoria, però, non dovrebbe essere la prima soluzione: è preferibile verificare nei log se il problema dipende realmente dalla memoria e capire quale processo la sta utilizzando.

Aggiornamenti incompleti o file danneggiati

Un aggiornamento interrotto può lasciare WordPress, un plugin o un tema in uno stato incoerente.

Può succedere, ad esempio, per:

• timeout del server;
• spazio disco insufficiente;
• problemi durante il trasferimento dei file;
• permessi errati;
• interruzioni durante l’aggiornamento.

Problemi lato server

Non tutto ciò che appare come un problema WordPress nasce necessariamente da WordPress.

Configurazione PHP, permessi dei file, errori del web server, limiti delle risorse o problemi dell’hosting possono produrre sintomi molto simili.

Per questo motivo, quando plugin e tema non sembrano essere la causa, i log del server diventano particolarmente importanti.

Prima di intervenire: cosa è cambiato?

Una delle domande più utili da porsi è molto semplice:

cosa è successo immediatamente prima della schermata bianca?

Hai:

• aggiornato WordPress?
• aggiornato un plugin?
• installato un nuovo plugin?
• modificato il tema?
• aggiunto uno snippet PHP?
• cambiato versione di PHP?
• spostato il sito su un nuovo server?

La risposta può restringere enormemente il campo della ricerca.

Se il sito funzionava fino a pochi minuti prima e il problema è comparso subito dopo una modifica, conviene iniziare proprio da lì.

1. Controlla la mail dell’amministratore WordPress

Le versioni moderne di WordPress includono una Recovery Mode, introdotta con WordPress 5.2.

Quando WordPress rileva alcuni errori PHP fatali, può inviare un messaggio all’indirizzo email dell’amministratore del sito con informazioni sull’errore e, quando possibile, un collegamento speciale per accedere al sito in modalità di recupero.

Controlla quindi:

• la casella email associata all’amministratore WordPress;
• la cartella spam;
• eventuali sistemi antispam o filtri della posta.

In Recovery Mode WordPress può permetterti di accedere all’amministrazione anche se un plugin o un tema sta causando il problema.

Questo spesso rende possibile disattivare direttamente il componente responsabile senza utilizzare FTP o il pannello dell’hosting.

2. Controlla i log degli errori

Quando compare una schermata bianca, il browser spesso non mostra informazioni sufficienti per capire cosa sia successo.

Il server, invece, potrebbe aver registrato esattamente l’errore.

Il primo posto da controllare è quindi il log PHP o error log disponibile nel pannello del tuo hosting.

Un errore come:

PHP Fatal error

seguito dal percorso di un file può indicare immediatamente quale plugin, tema o componente ha provocato il problema.

Questa informazione è molto più utile di una serie di tentativi casuali.

3. Attiva temporaneamente il debug di WordPress

Se non riesci a ottenere informazioni utili dai log del server, WordPress dispone di un proprio sistema di debug.

Nel file wp-config.php puoi utilizzare:

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

Con questa configurazione WordPress registra gli errori nel file:

/wp-content/debug.log

senza mostrarli pubblicamente ai visitatori.

WP_DEBUG, WP_DEBUG_LOG e le relative impostazioni fanno parte degli strumenti ufficiali di debugging di WordPress.

Il debug dovrebbe essere utilizzato per individuare il problema e successivamente disattivato su un sito in produzione.

4. Disattiva i plugin

Se sospetti che il problema sia causato da un plugin e riesci ancora ad accedere alla dashboard, puoi disattivare temporaneamente i plugin e verificare se il sito torna a funzionare.

Se il problema scompare, riattivali uno alla volta.

Dopo ogni riattivazione controlla nuovamente il sito.

Quando la schermata bianca ricompare, avrai probabilmente individuato il plugin coinvolto.

Questa procedura è indicata anche nella documentazione ufficiale WordPress per diagnosticare la White Screen of Death.

Se non riesci ad accedere a WordPress

Puoi intervenire tramite SFTP, FTP oppure attraverso il file manager del tuo hosting.

Vai nella directory:

wp-content/

e rinomina temporaneamente:

plugins

ad esempio in:

plugins-disabled

In questo modo WordPress non riuscirà più a caricare i plugin presenti nella directory.

Se il sito torna a funzionare, hai una forte indicazione che uno dei plugin sia coinvolto.

Ripristina quindi il nome originale della cartella e procedi identificando il plugin responsabile.

Se sai già quale plugin sospettare, puoi rinominare solamente la sua directory invece dell’intera cartella plugins.

5. Verifica il tema attivo

Se la disattivazione dei plugin non cambia nulla, il passo successivo è verificare il tema.

Se puoi accedere alla dashboard, passa temporaneamente a un tema WordPress standard compatibile con la tua installazione.

Se non puoi entrare nell’area amministrativa, puoi utilizzare SFTP o il file manager dell’hosting e rinominare la directory del tema attualmente attivo all’interno di:

wp-content/themes/

WordPress documenta anche questa procedura tra i controlli consigliati per una schermata bianca.

Se il sito torna visibile utilizzando un altro tema, dovrai indagare nel tema precedente o nelle personalizzazioni effettuate.

6. Controlla eventuale codice personalizzato

Se utilizzi snippet PHP, plugin sviluppati internamente o modifiche manuali al tema, verifica soprattutto gli interventi effettuati poco prima del problema.

Un errore anche molto piccolo può causare un fatal error.

Controlla in particolare:

• functions.php;
• plugin personalizzati;
• mu-plugin;
• snippet inseriti tramite plugin dedicati;
• file modificati manualmente;
• integrazioni sviluppate su misura.

Se utilizzi Git o un altro sistema di versionamento, confrontare le ultime modifiche può velocizzare enormemente la diagnosi.

7. Controlla versione e configurazione PHP

Un plugin può funzionare correttamente per mesi e iniziare improvvisamente a generare errori dopo un cambio di versione di PHP.

Verifica quindi quale versione PHP utilizza il sito e se tutti i componenti installati dichiarano di supportarla.

La soluzione non dovrebbe essere semplicemente tornare a una versione PHP obsoleta.

Se il problema dipende da codice non più compatibile, è preferibile aggiornare o sostituire il componente coinvolto.

8. Cache e sistemi intermedi

Se l’errore compare solo in alcune condizioni, verifica anche eventuali sistemi di cache:

• plugin di caching;
• cache dell’hosting;
• reverse proxy;
• CDN;
• object cache.

Dopo aver risolto la causa principale, svuota le cache in modo da evitare che una versione precedente della pagina continui a essere servita.

La cache raramente dovrebbe essere considerata automaticamente la causa di una vera schermata bianca generata da un fatal error, ma può rendere più difficile capire se una modifica ha effettivamente risolto il problema.

E il database?

Anche problemi al database possono manifestarsi con pagine vuote o comportamenti anomali, ma non conviene iniziare modificando direttamente le tabelle.

Verifica prima i messaggi nei log.

Se vengono indicati errori relativi a MySQL o MariaDB, connessioni al database, query o tabelle danneggiate, allora ha senso approfondire quella direzione.

Interventi sul database dovrebbero comunque essere effettuati solamente dopo aver creato un backup affidabile.

Il backup viene prima delle modifiche invasive

Se il sito non è completamente irraggiungibile, crea un backup prima di iniziare interventi importanti.

Idealmente dovresti avere una copia di:

• file del sito;
• directory wp-content;
• database;
• configurazione di WordPress.

Se disponi già di backup automatici, verifica che siano realmente disponibili e che la copia precedente al problema sia recuperabile.

Ripristinare immediatamente un backup non è però sempre la soluzione migliore.

Se non identifichi la causa dell’errore, potresti ripristinare il sito per ritrovarti con lo stesso problema al successivo aggiornamento.

Una procedura pratica per diagnosticare la schermata bianca

In sintesi, conviene procedere in quest’ordine:

1. Ricostruisci cosa è cambiato immediatamente prima dell’errore.
2. Controlla la mail dell’amministratore per l’eventuale Recovery Mode.
3. Controlla i log PHP e del server.
4. Se necessario, abilita temporaneamente il debug di WordPress.
5. Verifica plugin e tema.
6. Controlla codice personalizzato e compatibilità PHP.
7. Solo dopo passa a configurazione server, database e problemi meno comuni.

L’obiettivo non è semplicemente far riapparire il sito.

È capire perché ha smesso di funzionare.

Schermata bianca risolta: cosa fare dopo?

Una volta individuata la causa:

• aggiorna o sostituisci il componente responsabile;
• elimina eventuale codice non compatibile;
• disattiva il debug se lo avevi attivato;
• svuota le cache;
• verifica frontend e backend;
• controlla nuovamente i log;
• crea un nuovo backup del sito funzionante.

È inoltre utile annotare cosa ha causato il problema e come è stato risolto, soprattutto per siti aziendali o gestiti da più persone.

Quando è meglio chiedere assistenza?

Se non hai familiarità con PHP, file del server o database, procedere per tentativi può peggiorare la situazione.

In particolare è consigliabile fermarsi prima di modificare direttamente:

• database;
• file del core WordPress;
• configurazione PHP;
• permessi di file e directory;
• configurazione del web server.

Una schermata bianca è un sintomo, non una diagnosi.

Individuare l’errore nei log e ricostruire ciò che è accaduto permette quasi sempre di affrontare il problema in modo molto più rapido e sicuro rispetto a modifiche casuali.

WPClinic Lab nasce proprio con questo approccio: capire prima la causa, intervenire solo dopo.