Errore schermata bianca in WordPress? Ecco come risolvere velocemente

Hai il problema della schermata bianca in WordPress e il tuo sito non è raggiungibile? È comparsa la scritta “Si è verificato un errore critico sul tuo sito web.“?

Non disperare, la white screen of death è un errore comune in WordPress.

Ecco come risolverlo, velocemente.

Se dovessi avere bisogno di aiuto, contattami.

Cause più comuni della schermata bianca

Le cause più comuni che portano a questo errore sono:

1. problemi con i plugin
2. conflitti con il tema attivo
3. limiti di memoria PHP insufficienti
4. errori nel file wp-config.php o .htaccess
5. errori di codice in funzioni personalizzate
6. problemi con l’hosting o il server

Soluzioni passo dopo passo

0. Backup

Prima di modificare qualche file, è sempre bene fare un bel backup di sicurezza di tutti i tuoi file e del database.

Se non vuoi creare un backup completo, crea almeno un backup dei file che andrai a modificare, prima di modificarli.

1. Controlla l’email

WordPress ha una funzionalità automatica di protezione contro gli errori fatali.

Se si dovessero riscontrare delle criticità, dovrebbe riuscire a mandare una email all’amministratore.

L’oggetto è: Il tuo sito [nomesito.it] ha un problema tecnico

Questo è il messaggio che è arrivato a me su uno dei miei siti:

Ciao!

WordPress, ha una funzionalità integrata che rileva quando un plugin o un tema provocano un errore irreversibile sul tuo sito e ti avvisa con questa email automatica.

In questo caso, WordPress ha incontrato un errore con il tuo tema, [NOME_TEMA].

Per prima cosa, vai al tuo sito web ([URL_SITO]) e controlla se ci sono problemi visibili. Successivamente, vai nella pagina in cui è stato rilevato l'errore ([URL_PAGINA_ERRORE]) e verifica se c'è qualche problema visibile.

Contatta il tuo host per richiedere assistenza per una investigazione più approfondita di questo problema.

Se il tuo sito appare danneggiato e non puoi accedere normalmente alla tua bacheca, WordPress ora ha una speciale "modalità di ripristino". Ciò ti consente di accedere in modo sicuro alla tua bacheca per controllare cosa non va.

https://[URL_SITO]/wp-login.php?action=enter_recovery_mode&rm_token=fzSktDdtULBywNI2Q9H6sd&rm_key=1vQ5k0lVOjS5c8LMvSeiPS

Per mantenere il tuo sito sicuro, questo link scadrà tra 1 giorno. Non preoccuparti di questo: ti verrà inviato un nuovo link se l'errore si ripresenta dopo la scadenza.

Se cerchi aiuto per questo problema, ti potrebbero essere chieste alcune delle seguenti informazioni:
Versione di WordPress 6.7.1
Tema attivo: [NOME_TEMA] (versione 1.0.0)
Plugin corrente:  (versione )
Versione PHP 8.3.15



Dettagli dell'errore
====================
Un errore di E_COMPILE_ERROR è stato causato nella linea 397 del file /data/vhosts/[URL_SITO]/httpdocs/wp-content/themes/[NOME_TEMA]/functions.php. Messaggio di errore: Cannot use isset() on the result of an expression (you can use "null !== expression" instead)

Come puoi vedere è segnalato il dettaglio dell’errore a fondo email così da capire su quale file agire senza fare troppi tentativi.

Ma la cosa ancora più bella è che viene fornitor un link per accedere alla modalità di ripristino (recovery mode) che ti permetterà di accedere alla dashboard e gestire eventuali plugin o temi da lì.

Per uscire dalla modalità di ripristino comparirà un apposito pulsante sulla barra di amministrazione.

2. Hai un backup recente?

Se hai un backup recente e funzionante, ripristina quello.

3-A. Puoi accedere alla Dashboard di WordPress?

Disabilita i plugin

Se puoi accedere alla dashboard di WordPress, inizia a disabilitare tutti i plugin.

Se l’errore della schermata bianca scompare, molto probabilmente hai qualche incompatibilità di qualche plugin.

Riattivarli uno alla volta per capire quale causa il problema.

Trovato il plugin prova ad aggiornare il plugin, e dopo, aggiorna anche WordPress.

Se non dovesse ancora funzionare e anche tutti gli altri plugin sono aggiornati, allora ti conviene lasciarlo disabilitato e cercare un nuovo plugin, almeno per il momento.

Cambia il tema attivo

Prova ad cambiare il tema attivo con un tema standard realizzato da WordPress.org.

Se l’errore dovesse scomparire, allora il problema potrebbe essere del tema o di qualche incompatibilità con dei plugin.

Aggiorna i plugin, aggiorna il tema, aggiorna WordPress.

Prova a riattivare il tema che causava la white screen of death.

3-B. Non puoi accedere alla Dashboard di WordPress?

Disabilita i plugin

Per disabilitare i plugin senza avere accesso alla dashboard, accedi via FTP e rinominare la cartella “/wp-content/plugins” con un altro nome (ad esempio “/wp-content/temp_plugins“).

Se il sito torna raggiungibile, uno dei plugin potrebbe creare un conflitto.

Rinomina nuovamente la cartella in “/wp-content/plugins” ed attiva uno alla volta i plugin per capire quale causa il problema.

Cambia il tema attivo

Se il problema non si risolve disattivando tutti i plugin, accedi via FTP e rinomina la cartella del tema in uso in “/wp-content/themes/” per forzare WordPress a usare il tema predefinito.

Se l’errore della schermata bianca scompare:

• rinomina la cartella del tema riportandolo al nome originale
• accedi alla dashboard
• aggiorna i plugin
• aggiorna il tema
• aggiorna WordPress

4. Aumentare la memoria PHP

Magari il problema può dipendere dalla poca memoria disponibile per il PHP.

Modificare il file /wp-config.php per incrementare il limite di memoria inserendo questo codice alla fine del file:

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

5. Controllare e correggere il file .htaccess

Magari c’è un errore nella configurazione del file /.htaccess che si trova nella root principale dell’installazione. Ripristinarlo a uno standard predefinito può risolvere il problema.

• accedi via FTP
• scarica il file originale
• crea un nuovo file .htaccess

Ecco cosa scrivere dentro il file .htaccess:

# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]

# Aggiungi una regola per indirizzare tutte le richieste a index.php
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

# END WordPress

• carica il nuovo file e sovrascrivi il precedente.

Ora dovresti riportare una alla volta tutte le modifiche del vecchio .htaccess sul nuovo per capire quale causa il problema.

6. Abilitare il debug di WordPress

Proviamo a capire cosa causa il problema.

Per abilitare il debug in WordPress aggiungi questo codice al tuo file wp-config.php che si trova nella root del tuo spazio web (se non sai di cosa sto parlando, prova a vedere questa guida su come modificare WordPress).

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

All’interno del file wp-config.php dovresti già avere il codice define('WP_DEBUG', true); , basta sovrascriverlo in quel punto.

In poche parole gli stiamo dicendo di creare i log degli errori, salvandoli sul file /wp-content/debug.log senza mostrarli a schermo.

Dal browser (Chrome, FireFox, Safari, …) fai il refresh della pagina che genera l’errore della schermata bianca.

Adesso WordPress dovrebbe aver scritto nel file /wp-content/debug.log i log relativi al problema.

Apri il file.

L’ultimo log dovrebbe essere quello generato da te (controlla l’orario). Normalmente troverai scritto cosa ha generato il problema.

7. Verificare errori lato server

Controlla i log degli errori sul proprio hosting, meglio contattare il servizio clienti a questo punto.

8. Contattami

Se hai ancora problemi e non riesci a risolvere, prova a contattarmi.

Prevenire il problema in futuro

Finalmente hai risolto l’errore critico sul sito e tutto è tornato alla normalità. Per prevenire il problema della schermata bianca in futuro, ti consiglio di:

• effettuare aggiornamenti regolari di plugin, tema e di WordPress
• testare modifiche su un ambiente di staging in locale o sul server remoto
• eseguire backup frequenti così da avere sempre un backup disponibile