Erreur critique WordPress : le plan d’action pour remettre votre site en ligne
Une erreur critique WordPress affiche ce message : « Il y a eu une erreur critique sur ce site ». Votre site devient donc inaccessible aux visiteurs. Pas de panique : dans la majorité des cas, en effet, la cause est identifiable en moins de trente minutes.
Cette erreur survient généralement après une mise à jour de plugin, de thème, ou de la version de PHP utilisée par votre hébergeur. Elle bloque l’exécution du code PHP et empêche donc l’affichage normal de la page. Par ailleurs, WordPress a prévu un système d’alerte automatique pour vous aider à réagir vite.
Je vous explique ici, concrètement, la méthode que j’applique sur les sites en production. D’abord, lire le mail de récupération. Ensuite, activer les journaux de debug. Puis isoler l’extension fautive. Enfin, remettre le site en ligne proprement.
Comprendre le message d’erreur critique WordPress
Depuis WordPress 5.2, un mécanisme de protection appelé « mode de récupération » a été introduit. Il détecte les erreurs fatales et limite ainsi leur impact.
Pourquoi WordPress affiche ce message
Le message apparaît quand une erreur fatale PHP interrompt l’exécution du site. C’est souvent un plugin incompatible, un thème mal codé, ou une fonction supprimée après une mise à jour. WordPress détecte l’erreur et coupe donc l’affichage, pour éviter d’exposer du code brut aux visiteurs.
Ce que voit le visiteur, ce que vous devez faire
Le visiteur voit une page blanche avec un message générique. Vous, en tant qu’administrateur, recevez normalement un email détaillé. C’est le point de départ du diagnostic. Sans cet email, cependant, il faut activer manuellement les journaux d’erreurs, une étape que je détaille plus loin.
Lire le mail de récupération WordPress
Dès qu’une erreur critique WordPress survient, un email est envoyé à l’adresse administrateur du site. Ce mail contient donc des informations précieuses pour la suite du diagnostic.
Le contenu du mail de récupération
Le mail indique le fichier et la ligne exacte où l’erreur s’est produite. Il précise aussi le nom du plugin ou du thème concerné, quand c’est identifiable. Enfin, il contient un lien unique pour entrer en mode de récupération, sans avoir besoin de se connecter normalement.
Que faire si le mail n’arrive jamais
Certains hébergeurs bloquent l’envoi d’emails depuis le serveur. Par ailleurs, le mail part parfois directement en spam. Dans ce cas, connectez-vous en FTP ou via le gestionnaire de fichiers de votre hébergeur pour investiguer directement. Vérifiez donc aussi le dossier spam avant de conclure à une absence d’envoi.
Activer WP_DEBUG_LOG pour diagnostiquer l’erreur critique WordPress
Si le mail ne suffit pas, il faut activer les journaux de debug. Concrètement, WP_DEBUG_LOG enregistre toutes les erreurs PHP dans un fichier texte, sans les afficher aux visiteurs.
Modifier le fichier wp-config.php
Avant toute modification, faites une copie de sauvegarde du fichier wp-config.php. Ensuite, ajoutez ces lignes juste avant la ligne « That’s all, stop editing ! » :
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Cette configuration active la journalisation sans exposer les erreurs sur le site public. C’est essentiel, car afficher les erreurs en direct révèle des informations sensibles à n’importe quel visiteur.
Consulter le fichier de log généré
Une fois l’option activée, WordPress crée un fichier debug.log dans le dossier wp-content. Ouvrez-le ensuite via FTP ou le gestionnaire de fichiers. Vous y trouverez la trace exacte de l’erreur, avec le chemin du fichier fautif. Par exemple, la documentation officielle de WordPress détaille toutes les constantes de débogage disponibles sur developer.wordpress.org. Pour aller plus loin sur le suivi global des incidents, consultez aussi mon article sur le monitoring d’erreurs et le tableau de bord du webmaster.
Isoler l’extension ou le thème responsable de l’erreur critique
Une fois la cause identifiée dans les logs, il faut confirmer le coupable. La méthode la plus fiable reste, en pratique, la désactivation ciblée.
Désactiver les plugins via FTP
Si l’administration WordPress est inaccessible, renommez le dossier du plugin suspect dans wp-content/plugins. WordPress le désactive ainsi automatiquement, dès qu’il ne trouve plus le dossier attendu.
cd wp-content/plugins
mv nom-du-plugin nom-du-plugin-desactive
Si le site revient en ligne après cette manipulation, vous avez donc trouvé le coupable. Sinon, remettez le nom d’origine et testez un autre plugin.
Tester le thème actif
Si aucun plugin n’est en cause, le thème peut être responsable. Basculez alors temporairement vers un thème par défaut de WordPress, en renommant le dossier du thème actif via FTP. WordPress rebasculera ainsi automatiquement sur un thème standard.
Utiliser le mode de récupération intégré
Le lien reçu par email vous connecte en mode de récupération. Dans ce mode, WordPress met en pause l’extension fautive et affiche une notification pour la désactiver manuellement. C’est donc la méthode la plus simple, quand l’email est disponible.
Remettre le site WordPress en ligne en toute sécurité
Une fois l’extension ou le thème fautif identifié, plusieurs options s’offrent à vous pour rétablir un fonctionnement normal.
Mettre à jour ou remplacer l’extension
Vérifiez d’abord si une mise à jour du plugin fautif est disponible. En pratique, l’incompatibilité vient souvent d’une version de PHP plus récente que celle prévue par le développeur du plugin. Si aucune mise à jour ne corrige le problème, cherchez donc une extension alternative avec une fonction équivalente.
Vérifier la compatibilité avec la version de PHP
Certaines erreurs critiques apparaissent après un changement de version PHP côté hébergeur. Consultez alors la documentation du plugin pour vérifier la compatibilité annoncée. La référence officielle du langage se trouve sur php.net. Pour la gestion technique du serveur au sens large, mon article sur l’administration serveur web détaille ces réglages.
Désactiver le mode debug après résolution
Une fois le problème réglé, repassez WP_DEBUG et WP_DEBUG_LOG à false. En effet, laisser ces options actives en permanence alourdit le serveur et accumule des fichiers de log volumineux, sans bénéfice pour le site en production.
define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
Prévenir une nouvelle erreur critique WordPress
Une fois le site rétabli, mieux vaut anticiper la prochaine panne plutôt que d’attendre qu’elle se reproduise.
Tester les mises à jour sur un environnement de test
Avant d’appliquer une mise à jour de plugin ou de thème sur le site en production, testez-la donc sur une copie du site. Cette pratique évite en effet la majorité des erreurs critiques liées aux mises à jour.
Mettre en place une sauvegarde automatique
Une sauvegarde récente permet de revenir en arrière en quelques minutes, si une mise à jour casse le site. C’est ainsi la sécurité minimale à avoir en place avant toute intervention. J’explique la mise en œuvre complète dans mon article sur le plan de maintenance WordPress. Par ailleurs, le suivi régulier des mises à jour et sauvegardes est détaillé dans mon guide sur la maintenance WordPress professionnelle.
| Symptôme | Cause probable | Action recommandée |
|---|---|---|
| Page blanche immédiate après mise à jour | Plugin ou thème incompatible | Désactivation via FTP |
| Erreur après changement d’hébergeur | Version de PHP différente | Vérifier la compatibilité PHP |
| Erreur intermittente | Conflit entre deux extensions | Désactivation une par une |
| Aucun mail de récupération reçu | Emails bloqués par l’hébergeur | Activer WP_DEBUG_LOG manuellement |
Procédure complète en cas d’erreur critique WordPress
Voici la séquence d’actions que je recommande, dans l’ordre.
- Consultez immédiatement votre boîte mail, y compris les spams, pour trouver le mail de récupération WordPress.
- Si le mail est présent, cliquez sur le lien pour entrer en mode de récupération.
- Si aucun mail n’arrive, activez WP_DEBUG_LOG dans wp-config.php, après avoir sauvegardé ce fichier.
- Consultez ensuite le fichier debug.log dans wp-content pour repérer le fichier fautif.
- Désactivez le plugin ou le thème suspect via FTP, en renommant son dossier.
- Vérifiez que le site fonctionne à nouveau normalement.
- Enfin, mettez à jour ou remplacez l’extension responsable, puis désactivez le mode debug.
Questions fréquentes
Que faire si je ne reçois pas le mail de récupération WordPress ?
Vérifiez d’abord le dossier spam. Si rien n’arrive, activez manuellement WP_DEBUG_LOG dans wp-config.php. Ainsi, vous pouvez consulter les erreurs directement dans un fichier, sans dépendre de l’envoi d’email par le serveur.
Comment savoir quel plugin cause l’erreur critique WordPress ?
Consultez le fichier debug.log généré par WP_DEBUG_LOG : il indique le fichier et la ligne concernés. Sinon, désactivez les plugins un par un via FTP, jusqu’à ce que le site refonctionne normalement.
L’erreur critique WordPress peut-elle venir de l’hébergeur ?
Oui, notamment après une mise à jour automatique de la version de PHP. Un plugin ou un thème ancien peut, en effet, ne pas être compatible. Vérifiez donc toujours la compatibilité annoncée par le développeur, avant de changer de version PHP.
Faut-il laisser WP_DEBUG activé en permanence ?
Non. WP_DEBUG_DISPLAY doit rester désactivé sur un site en production, pour ne pas exposer d’erreurs aux visiteurs. Activez WP_DEBUG_LOG uniquement le temps du diagnostic, puis désactivez-le une fois le problème résolu.
Reprendre le contrôle après une erreur critique WordPress
Une erreur critique WordPress se résout presque toujours avec méthode. D’abord le mail de récupération, ensuite les journaux de debug, puis l’isolation du fautif, enfin la remise en ligne. Si votre site reste bloqué, ou si vous préférez déléguer ce type d’intervention, l’équipe de VolcanaWeb peut diagnostiquer et remettre votre site en ligne rapidement.
Une erreur critique tombe rarement au bon moment. Si vous préférez que quelqu’un s’en occupe, je propose un suivi mensuel qui inclut le dépannage : la maintenance WordPress par VolcanaWeb.
Un commentaire