Pagina bianca su WordPress: leggere l'errore prima di cambiare qualsiasi cosa

«Errore critico» o pagina bianca: lo stesso guasto

Una pagina bianca è quasi sempre un errore fatale di PHP: un file del sito ha chiesto qualcosa di impossibile, e l'esecuzione si è fermata prima di mostrare qualsiasi cosa. Da WordPress 5.2, WordPress intercetta questi errori: invece di una pagina vuota mostra «Si è verificato un errore critico sul tuo sito web.» e invia un'email all'indirizzo di amministrazione del sito.

La pagina resta completamente bianca in alcuni casi: una versione di WordPress più vecchia, un errore che avviene prima che questa protezione sia caricata, la costante WP_DISABLE_FATAL_ERROR_HANDLER impostata a true, oppure un plugin di cache che serve una pagina vuota memorizzata durante il guasto. Il metodo che segue vale per tutti questi casi.

Tre interventi possono aspettare di aver letto l'errore: reinstallare WordPress, eliminare plugin, ripristinare un vecchio backup. Ognuno può cancellare impostazioni o dati recenti, mentre il messaggio di errore indica di solito con precisione quale componente disattivare, senza perdere nulla.

La scorciatoia: la modalità di recupero

Quando WordPress intercetta l'errore, invia all'indirizzo email di amministrazione del sito un messaggio intitolato «Il tuo sito [Nome del sito] ha un problema tecnico». Il messaggio nomina il plugin o il tema responsabile e contiene un link che apre la bacheca in modalità di recupero.

• In questa modalità, il componente difettoso è sospeso solo per voi: i vostri visitatori vedono ancora l'errore.
• Da Plugin o da Aspetto > Temi, disattivate il componente indicato nell'email, poi fate clic su «Esci dalla modalità di recupero» nella barra di amministrazione.
• Il link resta valido 24 ore, e WordPress invia al massimo un'email di questo tipo al giorno. Se non arriva, controllate la cartella spam, poi passate al metodo successivo.

Leggere l'errore: il log di debug

Collegatevi al sito via SFTP o dal file manager del vostro provider di hosting, aprite wp-config.php nella cartella principale e sostituite la riga define( 'WP_DEBUG', false ); con queste quattro righe:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Vanno inserite sopra il commento che chiude la parte modificabile del file (/* Finito, interrompere le modifiche! Buon blogging. */ su un WordPress installato in italiano). Ricaricate la pagina in errore, poi aprite wp-content/debug.log. WP_DEBUG_DISPLAY impostata a false tiene i messaggi nel file e fuori dalla pagina che vedono i vostri visitatori.

Se debug.log resta vuoto o non compare, PHP ha registrato l'errore per conto suo: cercate un file error_log nella cartella principale del sito o in wp-admin, oppure la sezione dei log degli errori nel pannello di controllo del vostro hosting.

Che cosa dice il messaggio, e la correzione che corrisponde

Un errore fatale sta su una riga: il tipo di errore, la sua descrizione, poi in seguito dal percorso completo del file e dal numero di riga. Il percorso è la parte più utile: wp-content/plugins/nome/ indica un plugin, wp-content/themes/nome/ un tema.

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

Disattivare il componente difettoso senza la bacheca

Via SFTP o con il file manager

Rinominate la cartella del plugin indicato nel messaggio, per esempio wp-content/plugins/nome-plugin in nome-plugin.off. WordPress non trova più il plugin e smette di caricarlo; le sue impostazioni restano salvate nel database, e WordPress lo disattiva alla successiva apertura della schermata Plugin.

Per un tema, rinominare la sua cartella in wp-content/themes fa tornare la bacheca, ma i visitatori vedono una pagina bianca finché nessun tema è attivo. Aprite subito Aspetto > Temi: WordPress rileva che il tema attivo non funziona e torna a un tema predefinito installato.

Con WP-CLI

wp plugin list --status=active
wp plugin deactivate nome-plugin
wp theme list
wp theme activate twentytwentyfive

Il primo comando registra quali plugin sono attivi, un'informazione utile prima di qualsiasi disattivazione in blocco. Se WP-CLI stesso si ferma sull'errore, aggiungete --skip-plugins --skip-themes al comando, così parte senza caricare plugin e tema. I plugin in wp-content/mu-plugins si caricano comunque; se l'errore viene da uno di loro, rinominate il suo file.

Quando il messaggio non nomina alcun componente, wp plugin deactivate --all disattiva tutti i plugin. Se il sito torna, riattivateli uno alla volta, ricaricando il sito ogni volta: l'ultimo riattivato prima che l'errore ricompaia è il responsabile.

Una volta che il sito è tornato

1. Rimettete define( 'WP_DEBUG', false ); e togliete WP_DEBUG_LOG da wp-config.php.
2. Eliminate wp-content/debug.log: si trova in una cartella accessibile dal web, chiunque può leggerlo, e contiene percorsi del server.
3. Aggiornate o sostituite il componente responsabile, dopo averne letto il registro delle modifiche.
4. Svuotate la cache del vostro plugin di cache, e quella del provider di hosting se ne ha una.
5. Per la prossima volta: provate gli aggiornamenti su una copia del sito prima di applicarli al sito online.