Écran blanc WordPress : méthode de diagnostic sans accès apparent

Un écran blanc WordPress est particulièrement déstabilisant parce qu’il ne donne parfois aucun indice : ni message, ni code d’erreur, ni accès à l’administration. Ce symptôme ne désigne pas une cause unique. Une erreur PHP, une extension, le thème actif, une limite de mémoire ou même un problème situé avant WordPress peuvent tous produire une page vide.

La bonne approche consiste donc à avancer de l’extérieur vers l’intérieur, en modifiant une seule chose à la fois et en notant le résultat. Avant toute intervention sur les fichiers, assurez-vous d’avoir une sauvegarde exploitable. Si ce n’est pas le cas, consultez d’abord comment créer une sauvegarde automatique WordPress fiable.

1. Confirmer qu’il s’agit bien d’un écran blanc lié à WordPress

Commencez par ouvrir plusieurs adresses : la page d’accueil, une page ou un article précis, /wp-login.php et /wp-admin/. Notez celles qui restent blanches et celles qui répondent normalement.

Essayez aussi dans une fenêtre privée et depuis un autre réseau, si possible. Cette vérification ne corrige rien, mais elle aide à écarter un cache local, une extension de navigateur ou une réponse mise en cache par un service intermédiaire.

Si vous avez accès au gestionnaire de fichiers de l’hébergement, créez temporairement un petit fichier HTML indépendant de WordPress dans le même répertoire public, puis ouvrez-le dans le navigateur. S’il s’affiche alors que les URL WordPress restent blanches, le serveur peut livrer des fichiers statiques : le diagnostic doit se concentrer sur l’exécution de WordPress et de PHP. S’il ne s’affiche pas non plus, vérifiez plutôt le domaine, le serveur Web, le pare-feu applicatif ou l’hébergement avant de modifier WordPress.

2. Activer un journal de débogage sans afficher les erreurs aux visiteurs

Lorsque l’administration est inaccessible, le fichier wp-config.php devient le point d’entrée le plus utile. Il se trouve normalement à la racine de l’installation WordPress et contient notamment la configuration de la base de données. La documentation officielle précise qu’il est chargé à chaque affichage non servie depuis un cache et qu’il peut contenir les constantes de débogage et de mémoire.

Faites d’abord une copie locale de ce fichier. Ensuite, ajoutez ou remplacez les constantes suivantes avant la ligne qui contient /* That's all, stop editing! */ :

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

Avec cette configuration, WordPress enregistre les erreurs, avertissements et avis dans wp-content/debug.log, sans les révéler dans le HTML public. Le fonctionnement de WP_DEBUG_LOG et de WP_DEBUG_DISPLAY est documenté dans le guide officiel Debugging in WordPress.

Rechargez une seule URL blanche, puis ouvrez wp-content/debug.log avec le gestionnaire de fichiers ou FTP. Cherchez d’abord les dernières lignes : elles indiquent souvent un fichier, une extension, un thème ou une fonction PHP précise. Ne publiez pas ce fichier et ne laissez pas le débogage activé plus longtemps que nécessaire, car le journal peut contenir des chemins de fichiers et d’autres renseignements techniques.

Si aucun fichier debug.log n’apparaît, consultez les journaux PHP offerts par votre hébergeur. Leur emplacement et leur nom varient d’un environnement à l’autre. Le journal PHP du serveur peut toutefois contenir une erreur fatale survenue avant que WordPress puisse écrire son propre journal.

3. Écarter toutes les extensions par FTP ou gestionnaire de fichiers

Un conflit d’extension est une cause fréquente d’écran blanc. Vous n’avez pas besoin d’ouvrir l’administration pour le vérifier.

1. Ouvrez le dossier wp-content.
2. Renommez plugins en plugins.hold.
3. Rechargez la page qui était blanche.

Cette manipulation empêche WordPress de charger les extensions ordinaires tout en préservant leurs fichiers et leurs réglages. La FAQ officielle de dépannage WordPress décrit aussi cette désactivation par renommage lorsque les menus d’administration ne sont pas accessibles.

Si le site revient, remettez immédiatement le nom plugins, puis activez les extensions une par une depuis l’administration, en testant la même page entre chaque activation. La première extension qui recrée l’écran blanc mérite d’être laissée désactivée jusqu’à ce que vous vérifiiez sa compatibilité, ses mises à jour et son journal d’erreurs.

Si renommer le dossier ne change rien, ne supprimez pas les extensions à l’aveugle : poursuivez avec le thème actif.

4. Tester le thème sans modifier ses fichiers

Un écran blanc qui apparaît après l’activation ou la mise à jour d’un thème pointe souvent vers le thème, son thème enfant ou une personnalisation PHP. Vérifiez d’abord qu’au moins un thème WordPress par défaut est installé dans wp-content/themes.

Ensuite, renommez uniquement le dossier du thème actuellement actif, par exemple en ajoutant .hold à son nom. WordPress tentera alors de basculer vers un thème par défaut disponible. La documentation sur les erreurs courantes indique précisément cette méthode lorsque l’administration est inaccessible et qu’un thème est soupçonné.

Si le site redevient visible, remettez le nom du dossier pour préserver les fichiers, mais ne réactivez pas immédiatement le thème problématique. Examinez le debug.log, les modifications récentes dans un thème enfant et les personnalisations ajoutées dans functions.php. Un thème enfant et son parent chargent tous deux leur fichier functions.php; du code dupliqué ou incompatible peut donc provoquer une erreur PHP. Pour éviter de créer un incident semblable lors d’une prochaine intervention, voyez aussi comment mettre WordPress à jour sans briser son site.

5. Vérifier une limite de mémoire PHP, sans masquer la cause

Une erreur de mémoire peut interrompre le traitement avant que WordPress n’affiche une page complète. Cherchez dans les journaux une mention semblable à Allowed memory size exhausted. N’augmentez pas la mémoire simplement parce qu’un écran est blanc : confirmez d’abord l’indice dans le journal.

Si l’erreur est bien liée à la mémoire, vous pouvez demander temporairement une limite plus élevée dans wp-config.php :

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

Cette constante demande à WordPress d’augmenter la mémoire PHP disponible pour le site, seulement si la configuration de l’hébergement l’autorise. Le guide Editing wp-config.php précise aussi qu’une hausse de mémoire peut cacher le véritable problème, notamment lorsqu’une fonction ou une extension consomme anormalement de ressources. Si la limite ne change pas ou si l’erreur revient, transmettez le message exact à l’hébergeur plutôt que de multiplier les valeurs.

Écran blanc, erreur 500 ou erreur critique : ne pas confondre les symptômes

Un écran blanc est un résultat visuel : le navigateur reçoit une page vide ou pratiquement vide. Il peut provenir d’erreurs PHP ou de base de données, comme le rappelle la documentation WordPress sur les erreurs courantes. En revanche, une erreur 500 est un statut HTTP explicite envoyé par le serveur ; elle demande des vérifications plus orientées vers la configuration serveur et les journaux. Consultez alors les causes fréquentes d’une erreur 500 WordPress.

Une erreur critique WordPress affiche habituellement un message indiquant qu’une erreur technique est survenue. Lorsqu’un tel message apparaît, suivez plutôt la démarche présentée dans Erreur critique sur WordPress : quoi faire avant de paniquer.

Une fois la cause isolée et corrigée, désactivez WP_DEBUG, retirez ou archivez le journal de débogage selon votre politique d’entretien, puis testez la page d’accueil, quelques contenus, le formulaire de connexion et l’administration. Cette dernière étape confirme que le correctif rétablit réellement le site sans laisser d’information de débogage accessible.