Déboguer un site WordPress : les outils de votre hébergeur et la bonne méthode
Page blanche, « Erreur 500 », « Il y a eu une erreur critique sur ce site », administration inaccessible : la plupart des pannes WordPress viennent d’une extension, du thème ou d’un réglage du serveur. Les outils fournis par votre hébergeur et ceux intégrés à WordPress permettent d’en trouver la cause rapidement. Voici lesquels utiliser et dans quel ordre.
L’essentiel
- Commencez par lire l’erreur : journal d’erreurs de l’hébergeur ou fichier
debug.logde WordPress. - N’affichez jamais les erreurs aux visiteurs : enregistrez-les dans un fichier.
- Testez les corrections sur une copie du site (staging) quand c’est possible.
Les outils de débogage à votre disposition
| Outil | Où le trouver | À quoi il sert |
|---|---|---|
| Journal d’erreurs du serveur | Espace d’hébergement (sur cPanel : « Erreurs » ou fichier error_log dans le dossier du site) | Voir les erreurs PHP et serveur avec le fichier et la ligne en cause |
| Mode débogage de WordPress | Fichier wp-config.php | Enregistrer les erreurs de WordPress, des extensions et du thème dans wp-content/debug.log |
| Santé du site | WordPress : Outils › Santé du site | Repérer une version de PHP obsolète, un module manquant, une tâche planifiée en échec |
| Mode de récupération | E-mail envoyé à l’administrateur après une erreur fatale | Accéder à l’administration en désactivant l’extension ou le thème fautif |
| Environnement de préproduction (staging) | Espace d’hébergement, selon l’offre | Tester une mise à jour ou une correction sans toucher au site en ligne |
| Sélecteur de version PHP | Espace d’hébergement | Revenir temporairement à la version précédente après une mise à jour qui casse le site |
| Outils de développement du navigateur | Touche F12 : onglets Console et Réseau | Repérer une erreur JavaScript, un fichier introuvable (404) ou une requête bloquée |
Activer le mode débogage de WordPress
Dans le fichier wp-config.php (à la racine du site, via le gestionnaire de fichiers de l’hébergeur, SFTP ou l’accès SSH), ajoutez ces lignes avant la ligne « C’est tout, ne touchez pas à ce qui suit » :
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Les erreurs sont alors écrites dans wp-content/debug.log sans être affichées aux visiteurs. Reproduisez le problème, puis ouvrez ce fichier : la dernière erreur indique généralement le dossier de l’extension ou du thème en cause.
Une fois le problème résolu, remettez WP_DEBUG à false et supprimez debug.log : ce fichier peut être lisible depuis le web et révéler des chemins ou des informations sur votre site.
La méthode pas à pas
- Notez ce qui a changé juste avant la panne : mise à jour d’une extension, du thème, de WordPress, de PHP, nouvelle extension, modification de code.
- Lisez l’erreur dans le journal du serveur ou
debug.log. - Si l’administration est inaccessible, utilisez le lien du mode de récupération reçu par e-mail ; à défaut, renommez le dossier de l’extension suspecte dans
wp-content/pluginspour la désactiver. - Isolez la cause : désactivez les extensions une à une (ou toutes, puis réactivez-les une par une) et passez temporairement à un thème par défaut. Faites-le de préférence sur la copie de préproduction.
- Vérifiez le serveur : limite de mémoire PHP atteinte (« Allowed memory size exhausted »), espace disque plein, la version de PHP incompatible avec une extension ancienne.
- Videz le cache après la correction pour que les visiteurs voient la version réparée.
Les erreurs les plus fréquentes
| Symptôme | Cause probable | Piste |
|---|---|---|
| « Il y a eu une erreur critique sur ce site » | Erreur fatale PHP (extension, thème, code) | Mode de récupération, debug.log |
| Erreur 500 | Erreur PHP ou fichier .htaccess incorrect | Journal du serveur ; renommer temporairement .htaccess puis réenregistrer les permaliens |
| Page blanche | Erreur fatale non affichée, mémoire insuffisante | Mode débogage, augmenter memory_limit |
| « Erreur lors de l’établissement de la connexion à la base de données » | Identifiants de base erronés ou serveur de base indisponible | Vérifier wp-config.php, contacter l’hébergeur |
| Mise en page cassée, boutons inactifs | Erreur JavaScript, conflit d’extensions, cache | Console du navigateur, purge du cache |
| Erreur 403 | Pare-feu de l’hébergeur ou extension de sécurité | Journal du pare-feu, liste des IP bloquées |
Les extensions utiles
- Query Monitor : affiche dans la barre d’administration les erreurs PHP, les requêtes lentes à la base de données, les hooks et les scripts chargés. À désactiver une fois le diagnostic terminé.
- Health Check & Troubleshooting : extension officielle de l’équipe WordPress qui permet de désactiver les extensions et de changer de thème pour vous seul, sans toucher à ce que voient les visiteurs.
Quand contacter l’hébergeur
Si le journal montre une erreur de serveur (base de données indisponible, limite de ressources atteinte, blocage du pare-feu) ou si le site reste en panne alors que toutes les extensions sont désactivées, contactez le support en joignant l’heure de la panne, l’URL et le message d’erreur. La qualité du support et des outils fournis (journaux, staging, sauvegardes, choix de PHP) est un vrai critère de choix : voir notre comparatif des hébergeurs web.
Questions fréquentes
Où se trouve le fichier debug.log ?
Par défaut dans le dossier wp-content, si WP_DEBUG et WP_DEBUG_LOG sont activés.
Le mode débogage ralentit-il le site ?
Légèrement, et il peut exposer des informations : ne le laissez actif que le temps du diagnostic.
Je ne reçois pas l’e-mail du mode de récupération, que faire ?
Désactivez l’extension suspecte en renommant son dossier dans wp-content/plugins par le gestionnaire de fichiers ou en SFTP.
Pour aller plus loin : Créer un site de staging WordPress ; Mettre en place une redirection 301.



