WordPress mostra solo una pagina bianca

WordPress mostra solo una pagina bianca: come risolvere la Schermata Bianca della Morte

State provando a visitare il vostro sito WordPress e vedete solo una pagina vuota e bianca? Nessun messaggio di errore, nessuna bacheca, nessun contenuto? Questo problema è comunemente noto come Schermata Bianca della Morte (White Screen of Death), abbreviato in WSoD.

Per quanto il nome suoni drammatico: nella maggior parte dei casi, i vostri contenuti, le immagini e le impostazioni non sono andati perduti. Di solito, il sito web è bloccato da un errore PHP, un plugin difettoso, un tema corrotto, un problema di limite di memoria o un conflitto dopo un aggiornamento. Con una ricerca metodica degli errori, la causa può generalmente essere isolata con successo.

Cos'è la Schermata Bianca della Morte?

La Schermata Bianca della Morte descrive una situazione in cui WordPress non genera più alcun output visibile. Al posto del sito web o della bacheca, appare solo una pagina vuota. A seconda della configurazione del server, in alternativa potrebbe essere visualizzato un messaggio come "Si è verificato un errore critico sul tuo sito web".

Sintomi tipici:

• La pagina iniziale rimane bianca,
• La bacheca non si carica più,
• Solo determinate sottopagine rimangono bianche,
• Il login funziona, ma subito dopo appare una pagina vuota,
• Il sito web non è raggiungibile dopo l'aggiornamento di un plugin,
• Il sito web è vuoto dopo il cambio di tema,
• Appare un errore PHP al posto del sito web,
• L'errore si verifica solo nel backend o solo nel frontend.

La causa può spesso essere individuata verificando se è interessato solo il sito web pubblico, solo la bacheca o entrambi.

Cause comuni

1. Controllate la vostra casella di posta elettronica

WordPress dispone di una modalità di protezione integrata per gli errori fatali. Quando si verifica un errore critico, WordPress invia spesso un'e-mail all'indirizzo dell'amministratore del sito web.

Questa e-mail può contenere:

• Un indizio sul plugin o tema difettoso,
• Un messaggio di errore tecnico,
• Un link alla modalità di ripristino,
• Informazioni sul file interessato,
• Suggerimenti per la risoluzione dei problemi.

Controllate anche la cartella dello spam. Tuttavia, se la consegna delle e-mail del vostro sito web non è configurata correttamente tramite SMTP, questo messaggio potrebbe mancare.

2. Utilizzare la modalità di ripristino

Se WordPress vi invia un link alla modalità di ripristino, dovreste usarlo come prima cosa. La modalità di ripristino consente spesso di accedere alla bacheca, anche se un plugin o un tema sta causando un errore.

In modalità di ripristino potete:

• Disattivare il plugin difettoso,
• Verificare il tema attivo,
• Eseguire aggiornamenti,
• Esaminare più da vicino gli errori critici,
• Rendere nuovamente accessibile il vostro sito web.

Se non è disponibile alcun link di ripristino, procedete con i passaggi successivi.

3. Attivare la modalità di debug

WordPress spesso nasconde gli errori PHP per motivi di sicurezza. Di conseguenza, vedete solo una pagina vuota. Con la modalità di debug potete rendere visibili gli indizi sulla causa o farli scrivere in un file di log.

Come attivare la modalità di debug tramite cPanel:

1. Accedete al vostro cPanel.
2. Aprite il Gestore file.
3. Navigate nella directory principale della vostra installazione di WordPress.
4. Aprite il file wp-config.php.
5. Cercate la riga define( 'WP_DEBUG', false );.
6. Modificatela con attenzione in define( 'WP_DEBUG', true );.
7. Salvate il file.
8. Ricaricate il sito web.

Se la riga non esiste, potete inserirla sopra la riga che indica che la modifica termina qui e WordPress viene caricato.

4. Configurazione di debug migliore: registrare gli errori invece di mostrarli

Sui siti web live è preferibile non mostrare gli errori pubblicamente, ma farli scrivere in un file di log. Per fare questo, potete utilizzare i seguenti valori nel file wp-config.php:

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

Gli errori verranno quindi frequentemente salvati nel seguente file:

wp-content/debug.log

Dopo l'analisi, dovreste disattivare nuovamente il debugging o almeno assicurarvi che il file di log non rimanga accessibile al pubblico.

5. Leggere correttamente i messaggi di errore

I messaggi di errore sembrano complicati a prima vista. Di solito, però, il messaggio contiene un indizio fondamentale: il percorso del file interessato.

Esempio:

Fatal error: Uncaught Error in /home/user/public_html/wp-content/plugins/beispiel-plugin/plugin.php on line 123

Il percorso qui punta a:

wp-content/plugins/beispiel-plugin/

Questo significa: È molto probabile che questo plugin stia causando l'errore. Se il percorso punta a wp-content/themes/, la causa è più probabilmente legata al tema.

6. Disattivare tutti i plugin per prova

Se non avete un indizio specifico, un conflitto tra plugin è spesso la causa più probabile. Potete disattivare tutti i plugin dall'esterno, senza usare la bacheca.

Come procedere tramite il Gestore file di cPanel:

1. Aprite il Gestore file in cPanel.
2. Navigate fino alla cartella wp-content.
3. Cercate la cartella plugins.
4. Rinominatele in plugins_old.
5. Visitate nuovamente il vostro sito web.

Se dopo questo passaggio il sito web si carica di nuovo, molto probabilmente uno dei plugin era la causa del problema.

Successivamente, rinominate la cartella riportandola a plugins. Nella bacheca di WordPress potrete quindi attivare i plugin uno alla volta finché l'errore non si ripresenta.

7. Disattivare un singolo plugin

Se il messaggio di errore punta già a un plugin specifico, non è necessario disattivare tutti i plugin.

1. Aprite wp-content/plugins/.
2. Cercate la cartella del plugin interessato.
3. Rinominatele, ad esempio da nomeplugin a nomeplugin_disattivato.
4. Verificate nuovamente il sito web.

Se il sito web funziona di nuovo, verificate se è disponibile un aggiornamento o se avete bisogno di un'alternativa al plugin.

8. Verificare se il tema è la causa

Se l'errore si verifica dopo l'aggiornamento di un tema, un cambio di tema o una modifica a functions.php, la causa è probabilmente il tema.

Procedura:

1. Aprite la cartella wp-content/themes/.
2. Cercate la cartella del vostro tema attivo.
3. Rinominate temporaneamente la cartella.
4. WordPress proverà quindi a ripiegare su un tema predefinito disponibile.

Affinché questo funzioni, dovrebbe essere installato un tema predefinito recente come Twenty Twenty-Four, Twenty Twenty-Five o un altro tema standard di WordPress.

9. Annullare un errore nel file functions.php

Se avete inserito del codice nel file functions.php poco prima dell'errore, rimuovete prima questa modifica.

Cause tipiche:

• Punto e virgola mancante,
• Funzione definita due volte,
• Parentesi errata,
• Codice PHP nel posto sbagliato,
• Snippet da una fonte non sicura,
• Codice per una versione diversa di WordPress.

Aprite il file tramite cPanel o FTP e rimuovete l'ultimo codice inserito. Salvate il file e provate di nuovo il sito web.

10. Verificare il limite di memoria PHP (PHP Memory Limit)

Se WordPress, WooCommerce, un page builder o un processo di backup richiedono più memoria di quella consentita, può verificarsi un Fatal Error. Spesso si vedono indicazioni come "Allowed memory size exhausted".

Esempio:

Fatal error: Allowed memory size of 134217728 bytes exhausted

Possibili soluzioni:

• Verificare il limite di memoria PHP in cPanel,
• Passare a una versione di PHP recente,
• Controllare i plugin ad alta intensità di risorse,
• Ottimizzare la configurazione del page builder o di WooCommerce,
• Verificare le risorse di hosting in caso di problemi ricorrenti.

Non aumentate i limiti alla cieca senza considerare la causa. Se un plugin consuma una quantità insolita di memoria, dovrebbe essere esaminato più a fondo.

11. Verificare la versione di PHP

Un cambio della versione di PHP può innescare errori se un vecchio plugin o tema non è compatibile. Al contrario, anche una versione di PHP molto vecchia può causare problemi.

Verificate in cPanel:

• Quale versione di PHP è attiva?
• La versione è compatibile con WordPress?
• I plugin e il tema sono compatibili con questa versione di PHP?
• L'errore si è verificato dopo un cambio di PHP?

Se l'errore è iniziato subito dopo un cambio di PHP, potete fare una prova ripristinando la versione precedente e successivamente aggiornare o sostituire i plugin interessati.

12. Rigenerare il file .htaccess

Un file .htaccess danneggiato porta più spesso a errori di reindirizzamento o errori 500, ma può altrettanto bloccare un sito web.

Come testare con cautela:

1. Aprite il Gestore file.
2. Cercate il file .htaccess nella directory principale di WordPress.
3. Rinominatele, ad esempio in .htaccess_old.
4. Visitate nuovamente il sito web.
5. Se riuscite a entrare di nuovo nella bacheca, andate su Impostazioni > Permalinks.
6. Cliccate su Salva le modifiche senza cambiare nulla.

WordPress genererà così un nuovo file .htaccess standard, a condizione che i permessi del file lo consentano.

13. Svuotare la cache

A volte la causa effettiva è già stata risolta, ma una cache continua a distribuire una pagina errata o vuota.

Svuotate:

• La cache di WordPress,
• Il plugin di caching,
• La cache del server, se attiva,
• La cache CDN, se utilizzata,
• La cache del browser.

Inoltre, testate il sito web in una finestra del browser in incognito.

14. Verificare i log degli errori (Error Logs) in cPanel

I log del server sono spesso la via più rapida per trovare la causa. Mostrano errori PHP, percorsi di file e orari.

Prestate attenzione a:

• Fatal error,
• Parse error,
• Allowed memory size exhausted,
• Call to undefined function,
• Cannot redeclare function,
• Percorsi verso wp-content/plugins/,
• Percorsi verso wp-content/themes/.

Se non riuscite a interpretare il messaggio, copiatelo in un ticket di supporto. Il percorso del file interessato è solitamente la cosa più importante.

15. Se solo la bacheca è bianca

Se il sito web pubblico funziona, ma la bacheca rimane bianca, la causa è spesso un plugin specifico per l'amministrazione, un widget della bacheca, un plugin di sicurezza, un page builder o un problema di memoria nel backend.

Verificate in particolare:

• Plugin di sicurezza,
• Plugin SEO con widget della bacheca,
• Plugin di statistica,
• L'amministrazione di WooCommerce,
• Page builder,
• PHP Memory Limit,
• Console del browser.

16. Se solo singole pagine sono bianche

Se è interessata solo una pagina specifica, la causa potrebbe risiedere in un blocco particolare, uno shortcode, un template o un elemento del page builder.

Cause possibili:

• Shortcode difettoso,
• Template del page builder danneggiato,
• Codice PHP in un widget,
• Integrazione errata,
• Galleria troppo grande,
• Problema con un prodotto WooCommerce,
• Funzione di un plugin attiva solo su questa pagina.

In questo caso, dovreste prima controllare la pagina interessata, il template utilizzato e i plugin impiegati su di essa.

17. Cosa NON fare

• Eliminare file di WordPress a caso.
• Modificare il database senza un backup.
• Eliminare tutti i plugin invece di rinominarli.
• Lasciare la modalità di debug pubblicamente attiva in modo permanente.
• Modificare direttamente i file del tema senza una copia.
• Sovrascrivere i backup prima che la causa sia nota.
• Installare plugin di riparazione sconosciuti da fonti non sicure.
• Rimettere live un negozio WooCommerce senza averlo testato.

18. Dopo la riparazione: testare completamente il sito web

Quando il sito web si carica di nuovo, non dovreste fermarvi subito. Verificate se tutte le funzioni importanti sono tornate a lavorare correttamente.

Testate:

• La pagina iniziale,
• La pagina dei contatti,
• I moduli (form),
• Il login,
• La bacheca,
• I menu,
• La visualizzazione mobile,
• Il carrello e la cassa di WooCommerce, se presenti,
• Il plugin SEO,
• Il caching,
• I log degli errori per verificare la presenza di nuovi messaggi.

Se un plugin è stato la causa, verificate se è necessario un aggiornamento, un'alternativa o una modifica della configurazione.

19. Prevenzione dei problemi di schermata bianca

Molti problemi di schermata bianca possono essere evitati con una buona manutenzione.

• Eseguire regolarmente gli aggiornamenti,
• Creare un backup prima degli aggiornamenti,
• Utilizzare un ambiente di staging per i siti web importanti,
• Utilizzare solo plugin aggiornati e supportati,
• Eliminare i plugin e i temi non necessari,
• Utilizzare un Child Theme per le modifiche al codice,
• Mantenere aggiornata la versione di PHP,
• Verificare i conflitti tra i plugin dopo gli aggiornamenti,
• Salvare i backup esternamente,
• Controllare i log degli errori in caso di anomalie.

Ordine consigliato per la risoluzione dei problemi

1. Controllare l'e-mail dell'amministratore: C'è un link di ripristino?
2. Verificare il backup: Esiste una copia di sicurezza recente?
3. Attivare il log di debug: Rendere visibili gli errori o registrarli.
4. Leggere il messaggio di errore: Identificare il percorso del plugin o del tema.
5. Disattivare i plugin: Rinominare il singolo plugin o l'intera cartella dei plugin.
6. Verificare il tema: Disattivare temporaneamente il tema attivo per prova.
7. Verificare il PHP Memory Limit: Specialmente in caso di errori di memoria.
8. Verificare la versione di PHP: Escludere un problema di compatibilità.
9. Verificare il file .htaccess: In caso di errori del server o di reindirizzamento.
10. Svuotare la cache: Rimuovere il vecchio output dell'errore.
11. Testare il sito web: Controllare frontend, backend, moduli e negozio.
12. Disattivare nuovamente il debug: Non mostrare pubblicamente i messaggi di errore.

Domande frequenti sulla Schermata Bianca della Morte

I mio contenuti sono andati perduti?

Nella maggior parte dei casi, no. La schermata bianca di solito significa semplicemente che WordPress non può essere caricato a causa di un errore. I contenuti e il database sono spesso ancora presenti.

Qual è la causa più comune?

I conflitti tra i plugin, gli aggiornamenti errati, i problemi del tema o gli errori PHP nelle personalizzazioni del codice sono cause molto frequenti.

Perché non vedo nessun messaggio di errore?

I messaggi di errore vengono spesso nascosti per motivi di sicurezza. Attivate la registrazione del debug per ottenere indizi.

Posso disattivare i plugin senza entrare nella bacheca?

Sì. Rinominate la cartella wp-content/plugins o la cartella di un singolo plugin tramite cPanel o FTP.

Cosa faccio con WP_DEBUG dopo la risoluzione dei problemi?

Impostate nuovamente WP_DEBUG su false o disattivate gli output pubblici di debug. Il debugging non dovrebbe essere visibile in modo permanente sui siti web live.

Un tema può causare la schermata bianca?

Sì. Soprattutto dopo gli aggiornamenti del tema, le modifiche al file functions.php o a causa di template incompatibili, un tema può essere la causa.

Cosa significa "Allowed memory size exhausted"?

WordPress o un plugin richiede più memoria PHP di quella disponibile. Verificate il Memory Limit, i plugin e le risorse del server.

Quando dovrei contattare il supporto?

Se non riuscite a interpretare il messaggio di errore, non avete accesso ai file, se è interessato un negozio WooCommerce o se il sito non funziona nonostante i test su plugin e temi.