Le cœur qui s'accélère, les mains moites, cette montée de panique... Votre site WordPress, votre projet, votre vitrine, est en panne. Un écran blanc, un message d'erreur cryptique, et tout s'arrête. Respirez. Je sais exactement ce que vous ressentez, car chaque utilisateur de WordPress est passé par là. La bonne nouvelle ? La plupart de ces erreurs, même les plus effrayantes, sont comme des énigmes avec une solution logique.
Oubliez les recherches frénétiques et les solutions hasardeuses. Ce guide n'est pas une simple liste de problèmes : c'est une méthodologie de diagnostic complète.
Je vais vous prendre par la main pour vous apprendre à devenir le propre médecin de votre site : comprendre les symptômes, poser le bon diagnostic et appliquer le remède adéquat, en toute sérénité.
Prêt à reprendre le contrôle ?
Avant toute intervention : la sauvegarde d'abord
Imaginez que vous êtes chirurgien. Entreriez-vous au bloc sans filet de sécurité ? Jamais. Pour votre site, c'est pareil.
Avant de toucher à la moindre ligne de code ou au moindre fichier, une seule règle d'or : faites une sauvegarde complète. C'est votre assurance vie, votre bouton "retour en arrière" magique qui vous sauvera en cas de mauvaise manipulation.
De nombreux hébergeurs proposent des sauvegardes automatiques. Vous pouvez aussi utiliser des extensions réputées comme UpdraftPlus ou Duplicator. Quelle que soit la méthode, assurez-vous d'avoir une copie récente de vos fichiers ET de votre base de données avant de poursuivre. C'est non négociable.
Le diagnostic : activer le mode débogage pour y voir plus clair
Une erreur WordPress, c'est souvent un message vague qui cache la véritable cause du problème. Pour le démasquer, nous allons activer le "mode débogage" de WordPress. C'est un outil puissant qui va forcer WordPress à nous donner des indices précis sur ce qui ne va pas.
Pour cela, vous aurez besoin d'un accès aux fichiers de votre site, via un client FTP (comme FileZilla) ou le gestionnaire de fichiers de votre hébergeur (cPanel, Plesk...).
- Connectez-vous à votre site et trouvez le fichier wp-config.php à la racine. C'est un peu la carte d'identité de votre site, alors manipulez-le avec soin.
- Ouvrez ce fichier et cherchez la ligne : /* C’est tout, ne touchez pas à ce qui suit! Joyeuses publications. */
- Juste avant cette ligne, ajoutez le code suivant :
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
- Enregistrez le fichier.
Pourquoi ces trois lignes ? La première (WP_DEBUG) active le mode diagnostic. La deuxième (WP_DEBUG_LOG) demande à WordPress d'écrire toutes les erreurs dans un fichier journal secret, au lieu de les afficher publiquement. La troisième (WP_DEBUG_DISPLAY) empêche que les erreurs ne s'affichent sur votre site, ce qui ne serait pas très professionnel pour vos visiteurs.
Le fichier journal, nommé debug.log, apparaîtra dans le dossier /wp-content/ et deviendra votre meilleur allié.
Tableau de diagnostic rapide : trouvez votre erreur en un clin d'œil
Pour vous orienter rapidement, voici un tableau des pannes les plus fréquentes. Identifiez votre symptôme et cliquez sur le lien pour sauter directement au remède.
| Erreur / Symptôme | Message d'Erreur Typique | Causes Fréquentes | Difficulté | Lien vers la Solution |
|---|---|---|---|---|
| Écran Blanc de la Mort | (Aucun) | Conflit plugin/thème, limite mémoire PHP | Moyen | Voir la solution |
| Erreur Serveur Interne | 500 Internal Server Error | Fichier.htaccess, limite mémoire, plugin | Moyen | Voir la solution |
| Erreur Base de Données | Error Establishing a Database Connection | wp-config.php incorrect, serveur MySQL | Élevé | Voir la solution |
| Maintenance Bloquée | Indisponibilité temporaire... | Fichier.maintenance non supprimé | Faible | Voir la solution |
| Contenu Introuvable | 404 Not Found | Permaliens corrompus, slug modifié | Faible | Voir la solution |
| Erreur Critique | Il y a eu une erreur critique... | Conflit PHP dans plugin/thème | Moyen à Élevé | Voir la solution |
Erreurs de serveur (codes 5xx) : quand votre hébergement vous parle
Les erreurs commençant par "5" sont des messages directs de votre serveur. Il essaie de vous dire qu'il a un problème, mais ne sait pas toujours lequel. C'est comme un patient qui dit "j'ai mal" sans pouvoir pointer où.
L'erreur 500 "Internal Server Error"
Causes possibles
C'est l'erreur la plus vague. Elle peut être causée par un fichier .htaccess corrompu, une extension ou un thème défectueux, ou une limite de mémoire PHP atteinte.
Solutions étape par étape
- Vérifier le fichier .htaccess : Via FTP, renommez le fichier .htaccess (à la racine de votre site) en .htaccess_old. Rechargez votre site. Si ça fonctionne, allez dans Réglages > Permaliens dans votre administration WordPress et cliquez sur "Enregistrer les modifications" (sans rien changer) pour régénérer un fichier .htaccess propre. Pour en savoir plus sur ce fichier, consultez la documentation officielle de WordPress.
- Désactiver les extensions : Si l'étape 1 ne fonctionne pas, le coupable est probablement une extension. Suivez la procédure de désactivation des plugins décrite dans la section sur l'écran blanc.
- Augmenter la mémoire PHP : Votre site a peut-être besoin de plus de "carburant" pour fonctionner. Suivez les instructions pour augmenter la limite de mémoire PHP.
L'erreur 502 "Bad Gateway"
Cette erreur signifie que le serveur a reçu une réponse invalide d'un autre serveur. C'est souvent un problème temporaire de votre hébergeur.
Attendez quelques minutes et rechargez la page. Si le problème persiste, contactez le support de votre hébergeur.
L'erreur 503 "Service Unavailable"
Le serveur est tout simplement surchargé ou en maintenance. Cela peut être dû à un pic de trafic soudain ou à une opération de maintenance chez votre hébergeur.
Comme pour l'erreur 502, la patience est souvent le meilleur remède. Si l'erreur persiste, contactez votre hébergeur.
L'erreur 504 "Gateway Timeout"
Un autre serveur n'a pas répondu assez vite. C'est presque toujours un problème du côté de votre hébergement.
Videz le cache de votre navigateur, mais si cela ne suffit pas, il faudra vous tourner vers le support technique de votre hébergeur.
Erreurs d'affichage et d'accès : les plus frustrantes
Ces erreurs sont particulièrement angoissantes car elles vous bloquent souvent l'accès à votre tableau de bord, vous laissant impuissant.
L'écran blanc de la mort (White Screen of Death)
Causes possibles
La fameuse "page blanche" est généralement le symptôme d'un conflit entre extensions, d'un problème avec votre thème, ou d'un épuisement de la mémoire PHP.
Solutions étape par étape
- Identifier un conflit d’extensions (méthode FTP) :
-
-
- Connectez-vous à votre site via FTP.
- Naviguez vers le dossier /wp-content/.
- Renommez le dossier plugins en plugins_old pour désactiver toutes les extensions.
- Vérifiez si votre site est de nouveau accessible. Si oui, un conflit d’extension est confirmé.
- Renommez plugins_old en plugins (les extensions restent désactivées).
- Connectez-vous à l’admin WordPress et réactivez les extensions une par une, en testant le site après chaque activation. Quand le problème réapparaît, la dernière activée est la coupable.
- Variante si le site est accessible mais présente un bug : désactivez les extensions une à une en renommant leur dossier (ex. akismet → akismet_old) puis rechargez le site à chaque fois. Quand le problème disparaît, l’extension renommée est la coupable.
-
- Identifier un conflit de thème : Si les extensions ne sont pas en cause, faites de même avec votre thème. Dans le dossier /wp-content/themes/, renommez le dossier de votre thème actif. WordPress basculera automatiquement sur un thème par défaut et votre site devrait revenir.
- Augmenter la mémoire PHP : Si rien de tout cela ne fonctionne, essayez d'augmenter la limite de mémoire PHP.
L'erreur critique de WordPress ("Il y a eu une erreur critique...")
Causes possibles
Introduite depuis WordPress 5.2, cette erreur est une version "améliorée" de l'écran blanc. Elle est presque toujours causée par un conflit PHP majeur dans une extension ou un thème.
Solutions étape par étape
- Vérifiez vos e-mails : WordPress envoie normalement un e-mail à l'administrateur du site avec des détails sur l'erreur, indiquant le fichier et l'extension/thème en cause. C'est la piste la plus rapide.
- Utilisez le mode débogage : Si vous n'avez pas reçu d'e-mail, activez le mode débogage. Le fichier debug.log vous donnera des informations précieuses.
- Procédez par élimination : Suivez exactement les mêmes étapes que pour l'écran blanc de la mort (désactivation des plugins puis du thème via FTP) pour isoler le responsable.
L'erreur de syntaxe ("Parse error: syntax error")
Causes possibles
Cette erreur est en fait une bonne nouvelle ! Elle est très précise. Elle survient lorsque vous avez ajouté ou modifié un bout de code (souvent dans le fichier functions.php) et que vous avez fait une faute de frappe : un point-virgule manquant, une parenthèse en trop, etc.
Solutions étape par étape
- Lisez le message d'erreur : Il vous indique le chemin exact du fichier (path/to/your/file.php) et le numéro de la ligne (on line 123) où se trouve l'erreur.
- Corrigez via FTP : Connectez-vous via FTP, téléchargez le fichier en question, ouvrez-le dans un éditeur de texte (pas un traitement de texte !) et allez à la ligne indiquée. Corrigez l'erreur (souvent, il suffit de comparer avec le code original) et renvoyez le fichier sur le serveur.
Erreurs de base de données : le cœur de votre site est touché
L'erreur de connexion à la base de données ("Error Establishing a Database Connection")
Causes possibles
Votre site est comme une voiture : les fichiers sont la carrosserie, la base de données est le moteur. Ce message signifie que la carrosserie ne parvient plus à communiquer avec le moteur.
Les causes sont souvent des identifiants de connexion incorrects dans le fichier ou une panne du serveur de base de données chez votre hébergeur.
Solutions étape par étape
- Vérifier les identifiants dans wp-config.php : C'est la cause la plus fréquente. Via FTP, ouvrez le fichier wp-config.php. Vérifiez attentivement ces quatre lignes :
define( 'DB_NAME', 'nom_de_votre_base' ); define( 'DB_USER', 'votre_utilisateur' ); define( 'DB_PASSWORD', 'votre_mot_de_passe' ); define( 'DB_HOST', 'localhost' );
Assurez-vous que ces informations correspondent exactement à celles fournies par votre hébergeur. Une seule faute de frappe suffit. Pour tout savoir sur ce fichier crucial, consultez la documentation officielle sur wp-config.php.
- Contacter votre hébergeur : Si les identifiants sont corrects, le problème vient probablement de leur côté. Le serveur MySQL est peut-être en panne ou surchargé. Contactez leur support technique.
- Vérifier via phpMyAdmin : Pour les plus experts, vous pouvez tenter de vous connecter à votre base de données via l'outil phpMyAdmin (disponible dans votre espace client hébergeur) avec les mêmes identifiants pour confirmer qu'ils fonctionnent.
Erreurs de contenu et de fichiers (codes 4xx)
L'erreur 404 "Not Found" sur vos pages ou articles
Causes possibles
Vous cliquez sur un lien interne et... page introuvable, alors que vous êtes sûr qu'elle existe. C'est généralement dû à un problème avec la structure des permaliens de WordPress, souvent après une migration ou l'installation d'une extension.
Solutions étape par étape
- Ré-enregistrer les permaliens (la solution magique) : C'est incroyablement simple et ça résout le problème 99% du temps.
- Allez dans votre administration WordPress, dans Réglages > Permaliens.
- Ne changez absolument rien.
- Cliquez simplement sur le bouton "Enregistrer les modifications" en bas de la page.
Cette action force WordPress à réécrire les règles dans votre fichier .htaccess et à tout remettre en ordre.
L'erreur 403 "Forbidden"
Causes possibles
Le serveur vous dit : "Je sais que cette page existe, mais vous n'avez pas le droit de la voir". C'est un problème de permissions de fichiers ou une règle de sécurité (via une extension ou le fichier .htaccess) qui est trop stricte.
Solutions étape par étape
- Vérifier les permissions de fichiers : Via FTP, vérifiez les permissions de vos dossiers et fichiers. Les valeurs correctes sont 755 pour les dossiers et 644 pour les fichiers. Votre client FTP vous permet de voir et de modifier ces permissions (souvent via un clic droit > "Permissions de fichier").
- Vérifier le fichier .htaccess : Une extension de sécurité a pu y ajouter une règle bloquante. Essayez de le renommer temporairement en .htaccess_old pour voir si cela résout le problème.
Autres problèmes courants
Le site bloqué en mode maintenance
Causes possibles
Lors d'une mise à jour, WordPress crée un fichier temporaire nommé .maintenance. Si la mise à jour est interrompue, ce fichier n'est pas supprimé et votre site reste bloqué sur le message "Indisponibilité temporaire pour cause de maintenance.".
Solutions étape par étape
- Supprimer le fichier .maintenance : Connectez-vous à la racine de votre site via FTP. Trouvez le fichier .maintenance et supprimez-le. C'est tout ! Votre site sera de nouveau en ligne instantanément.
L'erreur de mémoire PHP ("Allowed memory size exhausted")
Causes possibles
WordPress et ses extensions ont besoin d'une certaine quantité de mémoire vive (RAM) pour fonctionner, fournie par votre serveur. Si un processus est trop gourmand, il peut dépasser la limite allouée. Les hébergeurs fixent souvent des limites par défaut à 128 Mo ou 256 Mo.
Solutions étape par étape
- Augmenter la limite dans wp-config.php : C'est la méthode la plus simple. Ouvrez votre fichier wp-config.php et, juste avant la ligne "C'est tout...", ajoutez ce code :
define('WP_MEMORY_LIMIT', '256M');Cela demande à WordPress d'allouer 256 Mo de RAM. Si le problème persiste, le souci est peut-être plus profond (une extension avec une fuite de mémoire).
Les erreurs de contenu mixte (Mixed Content) après un passage en HTTPS
Causes possibles
Votre site est bien en HTTPS (avec le petit cadenas), mais le navigateur vous signale que la connexion n'est pas entièrement sécurisée. Cela arrive quand certaines ressources (images, scripts...) sont encore appelées via leur ancienne adresse en HTTP.
Solutions étape par étape
- Utiliser une extension : L'extension "Really Simple SSL" a une option pour corriger automatiquement la plupart de ces erreurs.
- Faire une recherche-remplacement : Pour une solution plus pérenne, il faut remplacer toutes les occurrences de "http://votresite.com" par "https://votresite.com" dans votre base de données. Des extensions comme "Better Search Replace" permettent de le faire en toute sécurité.
Conclusion : vous êtes désormais aux commandes
Fini la panique ! Vous détenez maintenant une méthode fiable pour affronter la quasi-totalité des erreurs WordPress. Souvenez-vous de ce processus en quatre temps : Sauvegarder, Activer le débogage, Isoler la cause, Appliquer la solution. C'est cette approche structurée qui transforme un problème angoissant en un défi surmontable.
Mettez ce guide dans vos favoris. La prochaine fois qu'une erreur pointera le bout de son nez, vous saurez exactement quoi faire. Et pour aller plus loin, n'hésitez pas à consulter nos autres guides dont celui sur le renforcement de la sécurité WordPress.
