WordPress schermo bianco

Aprire il proprio sito e trovare WordPress con lo schermo bianco, senza contenuti né indicazioni utili, rende difficile capire immediatamente cosa sia successo. Il problema è conosciuto anche come White Screen of Death o WSoD e può coinvolgere tutto il sito, soltanto il frontend, l’area di amministrazione oppure una singola pagina.

Una schermata bianca non significa necessariamente che il sito o i contenuti siano stati persi. Nella maggior parte dei casi bisogna individuare quale componente sta interrompendo il caricamento di WordPress e intervenire soltanto su quello.

In breve: controlla prima se /wp-admin funziona, verifica l’eventuale email della Recovery Mode e consulta debug.log o il log PHP del server. Se l’errore indica un plugin, un tema o un file specifico, isola quel componente prima di effettuare altre modifiche.

Indice dei contenuti

WordPress schermo bianco: perché succede?

La schermata bianca di WordPress compare quando il sistema non riesce a completare correttamente il caricamento della pagina. La documentazione ufficiale di WordPress indica tra le possibili cause errori PHP o del database e suggerisce di verificare soprattutto plugin, tema e informazioni ottenute tramite il debug.

Le cause più comuni sono:

  • un plugin incompatibile o che genera un errore;
  • un problema nel tema o nel tema child;
  • codice personalizzato errato;
  • un aggiornamento non completato correttamente;
  • un errore PHP;
  • memoria PHP insufficiente;
  • file WordPress corrotti o incompleti;
  • problemi di cache o ottimizzazione;
  • più raramente, errori del database o dell’infrastruttura server.

Prima di intervenire, se possibile, verifica di avere a disposizione un backup recente di file e database. Evita inoltre di cambiare più elementi contemporaneamente: la diagnosi è molto più semplice se esegui una modifica alla volta e controlli il risultato.

Prima diagnosi: dove compare lo schermo bianco?

Prima di disattivare plugin o modificare configurazioni, cerca di capire esattamente dove si manifesta il problema.

Il sito è bianco ma wp-admin funziona

Se riesci ad accedere normalmente a:

tuodominio.it/wp-admin/

ma le pagine pubbliche non vengono visualizzate, concentra inizialmente i controlli su:

  • tema e template;
  • page builder;
  • shortcode;
  • plugin che modificano il frontend;
  • cache;
  • sistemi di minificazione e ottimizzazione;
  • JavaScript o CSS, se il contenuto HTML viene comunque generato.

La possibilità di utilizzare il backend rende molto più semplice disattivare temporaneamente i componenti sospetti.

WordPress schermo bianco anche in wp-admin: cosa controllare

Se non funzionano né il sito pubblico né l’area amministrativa, aumenta la probabilità che sia presente un problema più generale.

Controlla soprattutto:

  • Recovery Mode;
  • log PHP;
  • debug.log;
  • plugin;
  • tema;
  • modifiche recenti a functions.php o altri file PHP;
  • aggiornamenti appena eseguiti;
  • risorse disponibili sul server.

Solo una pagina è bianca

Se il resto del sito funziona normalmente, evita di iniziare disattivando tutto WordPress.

Controlla innanzitutto gli elementi specifici della pagina interessata:

  • template utilizzato;
  • widget;
  • shortcode;
  • blocchi;
  • query personalizzate;
  • moduli;
  • elementi del page builder.

Un errore localizzato richiede prima di tutto una diagnosi localizzata.

Controlla se WordPress ha attivato la Recovery Mode

Prima di modificare file tramite FTP o File Manager, controlla la casella email associata all’amministrazione del sito.

WordPress dispone della Recovery Mode, una funzione integrata che può attivarsi quando viene rilevato un errore PHP fatale durante il caricamento. In questi casi WordPress può inviare all’indirizzo amministrativo un’email contenente informazioni sul problema e un link speciale per accedere al backend in modalità di recupero.

La funzione è documentata nella guida ufficiale alla Recovery Mode di WordPress.

Controlla anche:

  • spam;
  • posta indesiderata;
  • eventuali filtri antispam;
  • l’indirizzo email amministrativo configurato in WordPress.

All’interno della Recovery Mode, il componente che genera l’errore può essere temporaneamente sospeso per la sessione amministrativa, consentendo di entrare nel pannello e intervenire.

Se non hai ricevuto nessuna email, passa all’analisi dei log.

Attiva il debug di WordPress per individuare l’errore

Quando una pagina è completamente bianca, uno dei controlli più utili consiste nel recuperare l’errore reale generato dal sistema invece di provare soluzioni casuali.

Apri il file wp-config.php, presente nella cartella principale dell’installazione WordPress.

Prima di aggiungere nuove righe, verifica se WP_DEBUG, WP_DEBUG_LOG o WP_DEBUG_DISPLAY sono già definiti. Se lo sono, modifica i valori esistenti anziché dichiarare nuovamente le stesse costanti.

Per una diagnosi temporanea puoi utilizzare:

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

Inserisci o modifica queste impostazioni prima della riga finale del file wp-config.php che invita a interrompere le modifiche.

In questa configurazione:

  • WP_DEBUG abilita il debug;
  • WP_DEBUG_LOG permette di registrare gli errori;
  • WP_DEBUG_DISPLAY impostato su false evita di mostrarli direttamente ai visitatori.

La documentazione WordPress sul debugging raccomanda di utilizzare questi strumenti soprattutto in ambienti di sviluppo e staging. Su un sito pubblico è quindi opportuno lasciarli attivi soltanto per il tempo necessario alla diagnosi.

Dopo la modifica:

  1. ricarica la pagina che presenta il problema;
  2. apri /wp-content/debug.log;
  3. guarda soprattutto le righe più recenti;
  4. cerca errori fatali e percorsi che indicano plugin o temi specifici.

Tra i messaggi più utili puoi trovare:

PHP Fatal error

oppure:

Allowed memory size exhausted

Se il percorso dell’errore contiene, ad esempio:

/wp-content/plugins/nome-plugin/

il plugin indicato è il primo componente da verificare.

Se invece compare:

/wp-content/themes/nome-tema/

concentra la diagnosi sul tema o sul tema child.

Cosa fare se debug.log non viene creato

L’assenza del file /wp-content/debug.log non significa che non esista un errore.

Controlla anche il PHP error log del server, generalmente disponibile nel pannello dell’hosting.

A seconda del provider può essere chiamato:

  • Error Log;
  • PHP Error Log;
  • error_log;
  • Logs;
  • Registro errori PHP.

Il log dell’hosting può contenere informazioni che WordPress non è riuscito a registrare nel proprio debug.log, soprattutto quando l’errore avviene molto presto durante l’esecuzione.

Se non trovi né debug.log né i log server, chiedi al provider hosting dove vengono registrati gli errori PHP del dominio.

La pagina è davvero vuota? Controlla il sorgente HTML

Un controllo semplice può aiutarti a distinguere un errore PHP/server da un problema che riguarda soltanto la visualizzazione.

Apri la pagina bianca nel browser e visualizzane il codice sorgente.

Se il sorgente è praticamente vuoto o contiene pochissimo HTML, è probabile che WordPress abbia interrotto l’esecuzione prima di generare completamente la pagina.

Se invece nel sorgente sono presenti normalmente:

  • titoli;
  • testi;
  • menu;
  • markup HTML;
  • classi e contenuto della pagina;

ma sullo schermo non viene visualizzato nulla, vale la pena controllare anche:

  • CSS;
  • JavaScript;
  • animazioni;
  • page builder;
  • sistemi di minificazione;
  • ottimizzazioni frontend;
  • cache.

In questo secondo scenario il sito potrebbe aver generato correttamente l’HTML, ma qualcosa ne impedisce la corretta visualizzazione nel browser.

WordPress schermo bianco per un plugin: come verificarlo

Se il log punta a un plugin oppure il problema è comparso immediatamente dopo il suo aggiornamento, disattiva prima quel componente.

Se hai accesso a WordPress puoi farlo normalmente dalla sezione Plugin.

Se /wp-admin non è raggiungibile, utilizza SFTP, FTP o il File Manager dell’hosting e apri:

/wp-content/plugins/

Individua la cartella del plugin sospetto e rinominala, ad esempio:

nome-plugin

in:

nome-plugin-disabled

Ricarica quindi il sito.

Se torna a funzionare, hai un’indicazione molto forte sulla causa.

Quando non esiste alcun indizio preciso, puoi eseguire un test più generale rinominando temporaneamente:

plugins

in:

plugins-old

La documentazione ufficiale WordPress indica la rinomina della cartella dei plugin tra le procedure utilizzabili quando non è possibile accedere all’amministrazione.

Se la disattivazione risolve il problema, ripristina il nome della cartella e riattiva i plugin gradualmente fino a individuare quello responsabile.

Prima di riattivare definitivamente il componente controlla:

  • aggiornamenti disponibili;
  • compatibilità con WordPress;
  • compatibilità con la versione PHP del server;
  • eventuali problemi documentati dallo sviluppatore.

Verifica il tema attivo

Se i plugin non risultano responsabili, controlla il tema.

Quando puoi utilizzare la dashboard, passa temporaneamente a un tema WordPress predefinito disponibile nell’installazione.

Se il sito torna a funzionare, controlla:

  • tema principale;
  • tema child;
  • functions.php;
  • template personalizzati;
  • codice inserito manualmente;
  • modifiche eseguite poco prima dell’errore.

WordPress include anche il passaggio temporaneo a un tema predefinito tra le verifiche consigliate per la White Screen of Death.

Se hai modificato functions.php pochi minuti prima della comparsa dello schermo bianco, parti da quella modifica invece di intervenire indiscriminatamente sull’intero sito.

Controlla la memoria PHP solo quando ci sono indizi

Aumentare il limite di memoria viene spesso presentato come una soluzione universale alla schermata bianca di WordPress, ma non dovrebbe essere il primo tentativo.

Il controllo diventa particolarmente rilevante se nei log trovi:

Allowed memory size exhausted

In quel caso verifica:

  • memory_limit configurato in PHP;
  • eventuali limiti dell’hosting;
  • consumo anomalo di un plugin;
  • processi particolarmente pesanti;
  • operazioni che richiedono più memoria del previsto.

Aumentare la memoria può risolvere un’insufficienza reale di risorse, ma non corregge un plugin difettoso o un processo che utilizza memoria in modo anomalo.

Per questo è preferibile partire dal messaggio registrato nei log e non modificare i limiti PHP alla cieca.

Svuota cache e sistemi di ottimizzazione

La cache è particolarmente importante quando il backend funziona ma il frontend continua a mostrare una versione errata o una pagina vuota.

Prova a svuotare:

  • cache del plugin WordPress;
  • cache dell’hosting;
  • cache del browser;
  • cache della CDN, se presente.

Se il problema è comparso dopo aver modificato impostazioni relative a:

  • minificazione;
  • combinazione di CSS o JavaScript;
  • defer o delay JavaScript;
  • Critical CSS;
  • ottimizzazione automatica delle risorse;

disattiva temporaneamente quelle funzioni e controlla nuovamente la pagina.

Questo passaggio è ancora più utile se dal sorgente HTML hai verificato che WordPress sta generando normalmente il contenuto.

WordPress schermo bianco dopo un aggiornamento: cosa fare

Se la schermata bianca è comparsa immediatamente dopo l’aggiornamento di WordPress, di un plugin o del tema, considera quell’evento come uno dei primi indizi.

Procedi in questo ordine:

  1. controlla debug.log e il log PHP del server;
  2. identifica il componente appena aggiornato;
  3. verifica eventuali errori di compatibilità;
  4. controlla la versione PHP utilizzata;
  5. verifica che l’aggiornamento sia stato completato;
  6. valuta il ripristino soltanto dopo aver individuato il problema.

Evita di sostituire file o ripristinare immediatamente un backup molto vecchio senza sapere cosa stai correggendo.

Su un sito aziendale, un portale o un e-commerce potresti perdere dati generati successivamente al backup, come ordini, richieste, utenti o modifiche ai contenuti.

Una corretta gestione di un sito WordPress dovrebbe prevedere backup verificabili, aggiornamenti controllati e una procedura chiara per gli interventi di emergenza.

Quando controllare i file del core WordPress

Se plugin, tema, memoria e cache non spiegano il problema, può essere necessario verificare anche l’integrità dei file WordPress.

Questa situazione può verificarsi, ad esempio, dopo:

  • un aggiornamento interrotto;
  • problemi durante il trasferimento dei file;
  • modifiche manuali;
  • file mancanti o danneggiati.

Non modificare però casualmente i file presenti in wp-admin o wp-includes.

Prima di sostituire componenti del core:

  1. esegui un backup;
  2. conferma la versione di WordPress installata;
  3. analizza i log;
  4. verifica che il problema non dipenda da plugin o tema;
  5. utilizza esclusivamente file ufficiali della versione corretta.

Se non hai familiarità con questa procedura, è preferibile richiedere assistenza.

Gli errori da evitare durante la diagnosi

Quando WordPress mostra una schermata bianca, modificare troppe cose contemporaneamente può rendere il problema ancora più difficile da individuare.

Evita soprattutto di:

  • aggiornare tutti i componenti contemporaneamente sperando che l’errore scompaia;
  • cancellare plugin o temi senza conservarne una copia;
  • modificare direttamente i file del core;
  • mostrare pubblicamente errori PHP contenenti percorsi server;
  • aumentare ripetutamente i limiti PHP senza leggere i log;
  • ripristinare un backup senza controllarne data e contenuto;
  • lasciare il debug attivo più del necessario;
  • effettuare più modifiche senza verificare il risultato tra una e l’altra.

La regola più utile è semplice: una modifica, un test, un risultato.

In questo modo, quando il sito torna a funzionare, puoi identificare con maggiore precisione l’origine del problema.

Come prevenire nuove schermate bianche

Non tutti gli errori possono essere evitati, ma una corretta manutenzione riduce il rischio di blocchi e rende più rapido il ripristino.

È utile:

  • mantenere WordPress, tema e plugin aggiornati;
  • effettuare backup automatici;
  • verificare periodicamente che i backup siano ripristinabili;
  • utilizzare plugin mantenuti e provenienti da fonti affidabili;
  • eliminare componenti inutilizzati;
  • testare aggiornamenti importanti prima sui siti più delicati;
  • controllare compatibilità e versione PHP;
  • monitorare gli errori;
  • documentare modifiche tecniche importanti.

Se vuoi approfondire questo aspetto puoi leggere la guida alla manutenzione di un sito WordPress, dove trovi i controlli utili per mantenere il sito stabile nel tempo.

Quando è meglio richiedere assistenza WordPress

Puoi effettuare autonomamente i controlli di base se conosci File Manager o SFTP, wp-config.php, log PHP e procedure di backup.

È invece consigliabile fermarsi quando:

  • il sito è un e-commerce operativo;
  • non hai un backup verificato;
  • il log contiene errori che non riesci a interpretare;
  • sono coinvolti database o file del core;
  • sospetti un problema di sicurezza;
  • il sito torna online ma l’errore continua a ripresentarsi;
  • le modifiche potrebbero compromettere ordini, contatti o altre funzioni aziendali.

In questi casi non basta far scomparire temporaneamente la schermata bianca: è necessario identificare la causa tecnica e verificare che il sito sia tornato stabile.

Se hai un sito WordPress bloccato e vuoi capire quale componente sta causando il problema, puoi approfondire il servizio di consulenza WordPress e valutare un’analisi tecnica dell’installazione.

Domande frequenti sullo schermo bianco di WordPress

WordPress schermo bianco: quali sono le cause più comuni?

Una pagina bianca può essere provocata da errori PHP o del database, plugin incompatibili, problemi nel tema, codice personalizzato, aggiornamenti incompleti o risorse insufficienti. Il primo obiettivo dovrebbe essere individuare l’errore nei log anziché modificare componenti casualmente.

Come risolvo lo schermo bianco se non posso entrare in wp-admin?

Controlla prima l’eventuale email della Recovery Mode. In alternativa puoi accedere ai file tramite SFTP, FTP o File Manager, verificare wp-config.php, consultare i log ed eventualmente disattivare il plugin o il tema responsabile.

Dove trovo debug.log in WordPress?

Quando WP_DEBUG e WP_DEBUG_LOG sono configurati correttamente, WordPress può salvare gli errori nel file /wp-content/debug.log. Dopo la diagnosi è consigliabile disattivare nuovamente il debug su un sito pubblico.

Perché WordPress non crea debug.log?

Il file può non essere creato se il debug non è configurato correttamente, se non vengono registrati errori durante la richiesta o se il problema viene intercettato diversamente dal server. In questi casi controlla anche il PHP error log disponibile nell’hosting.

Lo schermo bianco significa che ho perso il sito?

No. Una schermata bianca indica che WordPress non sta completando o visualizzando correttamente la pagina, ma database, file e contenuti possono essere ancora presenti. Evita cancellazioni o ripristini non verificati finché non hai individuato la causa.