Dépanner les erreurs WordPress courantes : la méthode pas à pas

Ton site affichait ses pages normalement hier, et ce matin plus rien : un écran blanc, un message d’erreur, une page qui tourne dans le vide. La bonne nouvelle, c’est que la plupart des pannes WordPress ont une poignée de causes connues, et qu’elles se diagnostiquent avec méthode. La première règle : avant de toucher à quoi que ce soit, assure-toi d’avoir une sauvegarde récente, ou fais-en une des fichiers et de la base depuis le panneau de l’hébergeur.

Pour la plupart des manipulations ci-dessous, il te faut un accès aux fichiers du site. Si tu n’as jamais utilisé de client FTP, notre mode d’emploi de FileZilla te met en route en quelques minutes. Le gestionnaire de fichiers de ton hébergeur fait aussi l’affaire.

Écran blanc et « Il y a eu une erreur critique »

C’est la panne la plus fréquente. Depuis quelques années, WordPress n’affiche plus seulement une page blanche : il indique qu’une erreur critique s’est produite et invite à consulter la boîte mail de l’administrateur. Dans l’immense majorité des cas, la cause est une extension ou le thème, souvent juste après une mise à jour.

L’e-mail du mode de récupération

Quand une erreur fatale survient, WordPress envoie à l’adresse d’administration un e-mail qui précise l’extension ou le thème en cause et contient un lien spécial. Ce lien ouvre l’administration en mode de récupération : l’élément fautif y est mis en pause pour toi seul, ce qui te permet de le désactiver ou de le mettre à jour. Le lien n’est valable qu’un temps limité. Regarde dans les indésirables si tu ne le trouves pas.

Activer le journal des erreurs

Si aucun e-mail n’arrive, ouvre wp-config.php et remplace la ligne WP_DEBUG existante par :

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

Recharge la page en panne, puis ouvre le fichier wp-content/debug.log. La dernière ligne « Fatal error » indique le fichier et la ligne qui posent problème, et donc l’extension ou le thème concerné. Pense à remettre WP_DEBUG à false une fois le problème réglé : ce journal ne doit pas rester actif ni accessible en permanence. La documentation officielle sur le débogage détaille ces constantes.

Désactiver les extensions par FTP

Sans accès à l’administration, va dans wp-content et renomme le dossier plugins en plugins-off. Toutes les extensions sont alors désactivées. Si le site revient, renomme le dossier en plugins, puis renomme une à une les extensions suspectes jusqu’à trouver la coupable. Même principe pour le thème : renommer le dossier du thème actif fait basculer WordPress sur un thème par défaut, s’il en reste un installé.

Erreur 500 (Internal Server Error)

Une erreur 500 signale que le serveur n’a pas pu traiter la demande, sans en dire plus. Les causes les plus courantes :

• un fichier .htaccess corrompu : renomme-le, puis régénère-le depuis Réglages > Permaliens en cliquant sur « Enregistrer les modifications » ;
• une extension ou un thème en erreur : même méthode que ci-dessus ;
• une limite de mémoire atteinte ;
• une version de PHP incompatible, par exemple juste après un changement chez l’hébergeur. Notre article pour mettre à jour la version de PHP explique comment revenir en arrière.

Les journaux d’erreurs du serveur, accessibles depuis le panneau de l’hébergeur, donnent souvent la réponse exacte.

Erreur de connexion à la base de données

Le message (« Erreur lors de la connexion à la base de données » en français) signifie que WordPress n’arrive pas à joindre MySQL ou MariaDB. Vérifie dans cet ordre :

1. les identifiants dans wp-config.php : DB_NAME, DB_USER, DB_PASSWORD et DB_HOST, à comparer avec ceux du panneau de l’hébergeur (un mot de passe changé récemment est un grand classique) ;
2. l’état du serveur de base de données : une panne ou une surcharge chez l’hébergeur, à vérifier sur sa page d’état ou auprès du support ;
3. une base corrompue : WordPress propose un outil de réparation en ajoutant define( 'WP_ALLOW_REPAIR', true ); dans wp-config.php, puis en ouvrant /wp-admin/maint/repair.php. Retire la ligne ensuite.

Mode maintenance bloqué

Pendant une mise à jour, WordPress crée un fichier .maintenance à la racine du site et affiche un message d’indisponibilité. Si la mise à jour est interrompue, le fichier reste et le message aussi. Supprime ce fichier par FTP (il est caché : active l’affichage des fichiers cachés dans ton client), puis vérifie que l’extension ou le thème concerné a bien été mis à jour.

Mémoire épuisée

Le message « Allowed memory size exhausted » indique que PHP a manqué de mémoire. Tu peux relever la limite dans wp-config.php :

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

Cette constante ne peut pas dépasser la limite fixée par l’hébergeur ; si rien ne change, c’est la configuration PHP du serveur qu’il faut ajuster. Et si la mémoire s’épuise souvent, cherche plutôt l’extension trop gourmande.

Récapitulatif

Quand la panne résiste, touche un site qui vend ou que tu ne veux pas risquer d’aggraver, mieux vaut faire appel à un service de dépannage WordPress que d’enchaîner les manipulations au hasard. Et pour éviter que cela se reproduise, relis nos précautions avant une mise à jour : la plupart des pannes naissent là.

Cet article peut contenir des liens partenaires. Ils n'influencent jamais ce que nous écrivons.