L'écran blanc de la mort (White Screen of Death, ou WSOD) est l'une des pannes WordPress les plus courantes : votre site, ou seulement l'administration, affiche une page entièrement blanche, sans aucun message. C'est impressionnant, mais presque toujours réparable. Voici comment trouver la cause et la corriger.
Les causes les plus fréquentes
- une erreur PHP fatale provoquée par une extension ou un thème, souvent juste après une mise à jour ;
- un manque de mémoire PHP pour exécuter le site ;
- une incompatibilité avec la version de PHP de l'hébergement ;
- une erreur de syntaxe dans un fichier modifié à la main (par exemple functions.php) ;
- plus rarement, un fichier corrompu ou un problème de cache.
Étape 1 : vérifier vos e-mails
Depuis WordPress 5.2, un mode de récupération envoie à l'administrateur un e-mail intitulé « Votre site rencontre un problème technique », avec un lien pour se connecter et désactiver l'élément fautif.
- Cherchez cet e-mail dans la boîte de l'adresse administrateur, y compris dans les indésirables.
- Cliquez sur le lien du mode de récupération et connectez-vous.
- Désactivez l'extension ou le thème indiqué.
- Pas d'e-mail ? Passez à l'étape suivante.
Étape 2 : afficher l'erreur
Pour savoir ce qui plante, activez le journal d'erreurs. Dans le fichier wp-config.php, juste avant la ligne qui indique d'arrêter les modifications, ajoutez ces trois lignes, puis rechargez la page :
- define( 'WP_DEBUG', true );
- define( 'WP_DEBUG_LOG', true );
- define( 'WP_DEBUG_DISPLAY', false );
Pensez à nettoyer
Une fois le problème résolu, remettez WP_DEBUG à false et supprimez debug.log : ce fichier peut contenir des informations sensibles.
Étape 3 : désactiver les extensions, puis le thème
Si le journal ne suffit pas, procédez par élimination, en FTP ou via le gestionnaire de fichiers de l'hébergeur :
- Renommez le dossier wp-content/plugins en plugins-off, puis rechargez le site.
- Si le site revient, remettez le nom d'origine et réactivez les extensions une par une pour trouver la fautive.
- Si rien ne change, renommez le dossier du thème actif dans wp-content/themes : WordPress bascule sur un thème par défaut, s'il en existe un d'installé.
Étape 4 : mémoire, version de PHP, sauvegarde
- La mémoire : un manque de mémoire provoque lui aussi un écran blanc. Dans wp-config.php, vous pouvez demander davantage de mémoire, si l'hébergeur l'autorise : define( 'WP_MEMORY_LIMIT', '256M' );
- La version de PHP : vérifiez qu'elle est compatible avec vos extensions, car un changement de version côté hébergeur peut tout casser.
- Le dernier recours : restaurez une sauvegarde saine, comme expliqué dans notre guide sauvegarde WordPress.
Éviter que cela revienne
Les écrans blancs viennent le plus souvent d'une mise à jour mal préparée. Lisez notre article La mise à jour a cassé mon site WordPress et notre guide erreurs WordPress et leurs solutions. Besoin d'un coup de main ? Demandez un audit gratuit ou découvrez notre forfait de maintenance.