Page blanche WordPress : diagnostic et solutions

1Qu'est-ce que le White Screen of Death exactement ?

Le White Screen of Death (WSOD) est un état où WordPress retourne une réponse HTTP 200 (OK) mais avec un contenu vide. Le navigateur affiche donc une page blanche, sans aucun message d'erreur, sans favicon, sans rien.

Techniquement, cela arrive quand PHP rencontre une erreur fatale mais que :

• display_errors est désactivé (configuration de production normale)
• WP_DEBUG est à false (configuration WordPress par défaut)
• Aucun handler d'erreur custom ne capture l'exception

Résultat : PHP plante silencieusement et envoie une réponse vide au navigateur.

WSOD vs erreur 500 : la différence

• Erreur 500 : le serveur affiche "Internal Server Error" — au moins on sait qu'il y a un problème
• WSOD : page blanche, code HTTP 200, totalement silencieux — souvent dû à display_errors=Off

2Diagnostic en 3 minutes

Étape 1 — Activer l'affichage des erreurs PHP

Connectez-vous au site en FTP/SFTP et modifiez wp-config.php à la racine. Cherchez la ligne define('WP_DEBUG', false); et remplacez-la par :

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

Rechargez la page blanche : le message d'erreur exact devrait maintenant s'afficher à la place du blanc.

Étape 2 — Lire le message d'erreur

Plusieurs cas typiques :

• Fatal error: Allowed memory size of X bytes exhausted → mémoire saturée (cas n°1)
• Parse error: syntax error, unexpected ... → fichier PHP corrompu (cas n°2)
• Fatal error: Call to undefined function ... → plugin/thème incompatible (cas n°3)
• Fatal error: Maximum execution time exceeded → script trop long (cas n°4)

Étape 3 — Si rien ne s'affiche malgré WP_DEBUG

C'est que PHP est totalement désactivé ou qu'un handler global bloque la sortie. Consultez directement wp-content/debug.log via FTP, ou le fichier error_log du serveur (souvent à la racine ou dans le dossier logs/ de l'hébergeur).

3Les 6 causes principales du WSOD

1. Mémoire PHP épuisée (40 % des WSOD)

WordPress dépasse la limite mémoire allouée par PHP. Solution dans wp-config.php :

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

2. Conflit plugin (25 %)

Un plugin nouvellement installé ou mis à jour est incompatible avec votre version de PHP ou avec un autre plugin actif.

Solution : en FTP, renommez wp-content/plugins/ en plugins_OFF pour désactiver tous les plugins d'un coup. Si le site revient → c'est un plugin. Remettez le nom puis réactivez-les un par un.

3. Thème défectueux (15 %)

Surtout après changement de thème ou mise à jour du thème actif. Renommez le dossier du thème dans wp-content/themes/ ; WordPress bascule automatiquement sur un thème par défaut (Twenty Twenty-Four).

4. Fichier core WordPress corrompu (10 %)

Surtout après une mise à jour automatique interrompue. Téléchargez WordPress depuis fr.wordpress.org et écrasez les fichiers /wp-admin/ et /wp-includes/ via FTP. Préservez wp-config.php et /wp-content/.

5. Édition manuelle de fichier ratée (5 %)

Vous avez modifié functions.php du thème via l'éditeur WordPress et il manque un point-virgule ? C'est la cause typique du Parse error. Restaurez la dernière sauvegarde du fichier ou téléchargez à nouveau le thème.

6. Cache Object / Page corrompu (5 %)

Si vous utilisez Redis, Memcached ou un plugin de cache (WP Rocket, W3 Total Cache), un cache corrompu peut servir une réponse vide. Solution :

• Supprimez le contenu du dossier wp-content/cache/ en FTP
• Redémarrez Redis/Memcached si vous y avez accès
• Renommez wp-content/object-cache.php et advanced-cache.php pour les désactiver

4Cas particuliers de page blanche

Page blanche uniquement dans l'admin (frontend OK)

Le frontend marche mais /wp-admin/ renvoie une page blanche. Causes typiques :

• Plugin admin-only (User Role Editor, Admin Columns) qui plante. Désactivez via FTP.
• Cookie de session corrompu — videz le cache navigateur et les cookies du domaine.
• Permissions du dossier wp-admin/ incorrectes (doit être 755).

Page blanche après mise à jour WordPress

Très souvent une mise à jour de plugin ou de thème incompatible avec la nouvelle version de WordPress. Pour récupérer immédiatement :

// Dans wp-config.php
define('WP_PLUGIN_DIR', '/tmp/disabled-plugins');

Astuce : cela "déplace" virtuellement le dossier plugins vers un dossier inexistant, désactivant tous les plugins. Vous récupérez l'accès admin, puis vous pouvez retirer cette ligne et désactiver proprement.

Page blanche uniquement sur certaines pages

Si l'accueil marche mais qu'une page produit ou un article spécifique est blanc, c'est souvent :

• Un shortcode défectueux dans le contenu (essayez la même page sans le shortcode)
• Un Custom Field qui contient du code PHP en erreur
• Un plugin qui se déclenche uniquement sur ce type de page (WooCommerce sur les fiches produit, par exemple)

Page blanche avec un message court "There has been a critical error"

Depuis WordPress 5.2, c'est le mode "recovery" intégré. WordPress envoie un email à l'admin avec un lien de récupération qui désactive automatiquement le plugin fautif. Vérifiez la boîte mail liée au compte admin.

5Méthode pro pour résoudre un WSOD persistant

Si après les manipulations classiques le WSOD persiste, voici la méthode utilisée par un professionnel :

1. Accéder aux logs serveur directement : error_log dans le dossier du site ou via le panneau hébergeur. Y chercher la ligne timestampée correspondant à la requête qui produit le blanc.
2. Activer SAVEQUERIES dans wp-config pour voir les requêtes SQL exécutées : define('SAVEQUERIES', true);
3. Tracer manuellement avec error_log() dans les fonctions suspectes pour identifier où la chaîne casse.
4. Vérifier les hooks problématiques avec Query Monitor (gratuit) qui liste tous les hooks WordPress exécutés et leur temps de chargement.
5. Inspecter la base de données : table wp_options avec des entrées siteurl, home ou active_plugins corrompues sont une cause classique de WSOD silencieux.
6. Vérifier les processus en cours : un cron WordPress bloqué (wp-cron.php) peut saturer la mémoire à chaque appel.

6Comment éviter le WSOD à l'avenir

• Toujours tester les mises à jour sur staging avant production. La majorité des bons hébergeurs proposent cette fonctionnalité gratuitement.
• Ne jamais éditer un fichier PHP directement en production via l'éditeur WordPress. Utilisez FTP avec un éditeur qui sauvegarde automatiquement (VS Code + extension SFTP).
• Désactiver l'édition de fichiers depuis l'admin pour éviter les accidents : define('DISALLOW_FILE_EDIT', true); dans wp-config.
• Limite mémoire à 512M minimum en production, voire 768M pour les sites WooCommerce.
• Sauvegardes quotidiennes avec point de restauration en 1 clic (UpdraftPlus, BlogVault, WP Time Capsule).
• Monitoring uptime + alertes erreur 500/WSOD : UptimeRobot (gratuit) ou Pingdom alertent dès qu'une page renvoie autre chose qu'un 200 + contenu.
• Maintenance préventive mensuelle : nettoyage de la base, mise à jour des plugins, vérification des permissions, scan sécurité.