Checklist : les erreurs WordPress les plus fréquentes et comment les résoudre

Même si Word­Press est répu­té pour sa sim­pli­ci­té, il n’est pas rare de ren­con­trer des erreurs sur son site : page blanche, erreur 500, blo­cage en mode main­te­nance… Ces pro­blèmes peuvent sur­ve­nir après une mise à jour, l’ajout d’une exten­sion ou une mau­vaise manipulation.

Cette che­ck­list vous aide­ra à iden­ti­fier rapi­de­ment les erreurs les plus cou­rantes et à com­prendre où cher­cher pour les cor­ri­ger effi­ca­ce­ment. Pour chaque erreur lis­tée, nous vous indi­quons les symp­tômes, les causes pro­bables, des solu­tions de base et, si néces­saire, une res­source utile pour aller plus loin.

Uti­li­sez le som­maire de l’article pour accé­der direc­te­ment à l’erreur qui vous concerne.

L’écran blanc de la mort (WSOD)

Symptômes

• Le site (ou l’administration) affiche une page tota­le­ment blanche
• Aucun mes­sage d’erreur n’apparaît
• Par­fois visible uni­que­ment sur cer­taines pages, ou seule­ment côté admin

Causes probables

• Une erreur PHP dans un thème ou une extension
• Un pro­blème de mémoire insuffisante
• Un fichier cor­rom­pu ou mal écrit

Solutions de base

1. Acti­ver le mode debug de WordPress
   • Dans le fichier wp-config.php, ajou­tez ou modi­fiez la ligne sui­vante : define( 'WP_DEBUG', true ); Cela per­met de faire appa­raître les erreurs PHP à l’écran (à désac­ti­ver une fois le pro­blème résolu).
   • → Voir : Confi­gu­rer wp-config.php dans WordPress
2. Désac­ti­ver les exten­sions via FTP ou le ges­tion­naire de fichiers
   • Renom­mez tem­po­rai­re­ment le dos­sier /wp-content/plugins/ pour voir si le site revient.
3. Bas­cu­ler sur un thème par défaut
   • Si l’erreur per­siste, renom­mez le dos­sier de votre thème actif (/wp-content/themes/nom-du-theme) pour for­cer Word­Press à char­ger un thème par défaut comme Twen­ty Twenty-Four.

Ressource utile

→ FAQ o2switch – Débo­guer une page blanche ou une erreur 500

Erreur 500 (Erreur interne du serveur)

Symptômes

• Une page affiche « Erreur 500 – Inter­nal Ser­ver Error »
• Le site devient inac­ces­sible, y com­pris l’administration
• L’erreur peut être inter­mit­tente ou permanente

Causes probables

• Un fichier .htaccess corrompu
• Une exten­sion ou un thème incompatible
• Une limite de res­sources atteinte (mémoire PHP, temps d’exécution…)
• Une erreur tem­po­raire côté ser­veur (sur­charge, main­te­nance, mau­vaise configuration)

Solutions de base

1. Renom­mer le fichier .htaccess
   • Accé­dez à la racine du site via FTP ou le ges­tion­naire de fichiers, puis renom­mez .htaccess en .htaccess_old.
   • Ensuite, recon­nec­tez-vous à l’administration et ren­dez-vous dans Réglages > Per­ma­liens pour en géné­rer un nouveau.
2. Aug­men­ter la mémoire PHP dans wp-config.php
   • Ajou­tez la ligne sui­vante avant /* That's all, stop editing! */ :
     define( 'WP_MEMORY_LIMIT', '256M' );
3. Désac­ti­ver les extensions
   • Comme pour le WSOD, renom­mez tem­po­rai­re­ment le dos­sier /wp-content/plugins/ pour tes­ter si une exten­sion est en cause.
4. Contac­ter le sup­port si le pro­blème persiste
   • Si aucune solu­tion ne fonc­tionne, il est pos­sible qu’un inci­dent ser­veur soit en cause. Dans ce cas, contac­tez votre héber­geur pour vérifier.

Ressource utile

→ Blog o2switch – Com­prendre les pages d’erreurs HTTP
→ FAQ o2switch – Débo­guer une erreur 500

Erreur de connexion à la base de données

Symptômes

• Mes­sage affi­ché : « Erreur de connexion à la base de don­nées »
• Le site et l’interface d’administration sont tous deux inaccessibles
• Par­fois, un simple rafraî­chis­se­ment ne suf­fit pas à résoudre le problème

Causes probables

• Mau­vais iden­ti­fiants dans le fichier wp-config.php
• Ser­veur de base de don­nées tem­po­rai­re­ment inaccessible
• Base de don­nées sup­pri­mée ou déplacée

Solutions de base

1. Véri­fier les iden­ti­fiants de connexion dans wp-config.php
   • Assu­rez-vous que les constantes sui­vantes cor­res­pondent bien aux iden­ti­fiants de votre base de don­nées :
     define( 'DB_NAME', 'nom_de_la_base' );
define( 'DB_USER', 'utilisateur' );
define( 'DB_PASSWORD', 'mot_de_passe' );
define( 'DB_HOST', 'localhost' ); // ou une URL différente selon l’hébergeur
   • → Besoin d’aide pour modi­fier ce fichier ? Consul­tez notre guide : Confi­gu­rer le fichier wp-config.php dans WordPress
2. Véri­fier que la base de don­nées est acces­sible et cohérente
   • Connec­tez-vous à php­MyAd­min depuis votre espace d’hébergement.
   • Véri­fiez que : 
     • le nom de la base affi­ché cor­res­pond bien à celui indi­qué dans wp-config.php (DB_NAME)
     • la base contient bien des tables Word­Press (dont wp_options, wp_users, etc.)
     • le pré­fixe des tables cor­res­pond à celui indi­qué dans $table_prefix de votre fichier wp-config.php
   • Si la base n’existe pas, a été sup­pri­mée ou renom­mée, ou si elle ne contient pas les bonnes tables, cela peut expli­quer l’erreur de connexion.
3. Contac­ter l’hébergeur
   • Si les iden­ti­fiants sont cor­rects et que la base semble en ligne, il peut s’agir d’un inci­dent tem­po­raire côté ser­veur. N’hésitez pas à contac­ter le support.

Ressource utile

→ Docu­men­ta­tion Word­Press – FAQ Dépannage

Erreur 403 – Accès interdit

Symptômes

• Un mes­sage du type « 403 For­bid­den » s’affiche à la place d’une page du site
• Par­fois l’erreur concerne uni­que­ment l’administration ou une page spécifique
• Le site peut res­ter acces­sible mais cer­taines actions sont bloquées

Causes probables

• Règles res­tric­tives dans le fichier .htaccess
• Per­mis­sions de fichiers incorrectes
• Exten­sion de sécu­ri­té (type Word­fence, Solid Secu­ri­ty…) mal configurée
• Blo­cage par le ser­veur ou une pro­tec­tion web (ex. Mod­Se­cu­ri­ty, pare-feu)

Solutions de base

1. Véri­fier ou rem­pla­cer le fichier .htaccess
   • Renom­mez le fichier .htaccess à la racine du site (.htaccess_old), puis connec­tez-vous à Word­Press > Réglages > Per­ma­liens et cli­quez sur « Enre­gis­trer les modi­fi­ca­tions » pour en géné­rer un nouveau.
2. Véri­fier les per­mis­sions des fichiers
   • Assu­rez-vous que : 
     • Les dos­siers ont les per­mis­sions 755
     • Les fichiers ont les per­mis­sions 644
     • Des per­mis­sions trop res­tric­tives peuvent géné­rer une erreur 403.
3. Désac­ti­ver tem­po­rai­re­ment les exten­sions de sécurité
   • Via FTP ou le ges­tion­naire de fichiers, renom­mez le dos­sier de l’extension concer­née (par exemple wordfence devient wordfence_off) dans /wp-content/plugins/.
4. Contac­ter le sup­port en cas de doute
   • Si vous soup­çon­nez un blo­cage ser­veur (ex. Mod­Se­cu­ri­ty), votre héber­geur peut vous aider à lever la res­tric­tion ou iden­ti­fier la règle en cause.

Ressource utile

→ Blog o2switch – Com­prendre les pages d’erreurs HTTP

Erreur 404 sur toutes les pages sauf l’accueil

Symptômes

• L’accueil s’affiche cor­rec­te­ment, mais toutes les autres pages (articles, caté­go­ries, etc.) ren­voient une erreur 404
• Le conte­nu existe bien dans l’administration mais n’est pas acces­sible publiquement

Causes probables

• Pro­blème de réécri­ture d’URL (per­ma­lien)
• Fichier .htaccess man­quant ou incorrect
• Mau­vaise confi­gu­ra­tion du ser­veur web

Solutions de base

1. Réini­tia­li­ser les per­ma­liens dans WordPress
   • Allez dans Réglages > Per­ma­liens, puis cli­quez sim­ple­ment sur « Enre­gis­trer les modi­fi­ca­tions » (même sans rien modifier).
   • Cela per­met de régé­né­rer les règles de réécriture.
2. Renom­mer le fichier .htaccess et rafraî­chir les permaliens
   • Accé­dez à la racine du site via FTP ou le ges­tion­naire de fichiers, renom­mez .htaccess en .htaccess_old, puis répé­tez l’étape pré­cé­dente (réini­tia­li­ser les per­ma­liens) pour géné­rer un nou­veau fichier .htac­cess propre.

Ressource utile

→ Docu­men­ta­tion Word­Press – Erreurs fréquentes

Le site rencontre des difficultés techniques

Symptômes

• Mes­sage affi­ché à l’écran : « Le site ren­contre des dif­fi­cul­tés tech­niques. Veuillez véri­fier votre boîte de récep­tion… »
• Un e‑mail est envoyé à l’administrateur avec un lien pour accé­der au mode de récupération
• L’erreur peut concer­ner le front-end, l’administration ou les deux

Causes probables

• Une exten­sion ou un thème pro­voque une erreur fatale
• Un fichier PHP mal modi­fié ou corrompu
• Un conflit sur­ve­nu après une mise à jour

Solutions de base

1. Uti­li­ser le mode de récu­pé­ra­tion de WordPress
   • Si vous avez reçu l’e‑mail de Word­Press (à l’adresse admin du site), cli­quez sur le lien four­ni. Il vous per­met­tra d’accéder tem­po­rai­re­ment à l’administration avec cer­taines exten­sions désac­ti­vées, le temps de cor­ri­ger l’erreur.
2. Désac­ti­ver manuel­le­ment les exten­sions ou le thème fautif
   • Si vous n’avez pas reçu l’e‑mail ou qu’il ne fonc­tionne pas : 
     • Connec­tez-vous via FTP ou le ges­tion­naire de fichiers
     • Renom­mez le dos­sier /wp-content/plugins/ pour désac­ti­ver toutes les extensions
     • Si néces­saire, renom­mez le dos­sier du thème actif dans /wp-content/themes/ pour for­cer le retour à un thème par défaut
3. Acti­ver le mode debug pour iden­ti­fier l’erreur
   • Dans le fichier wp-config.php, ajou­tez ou modi­fiez la ligne sui­vante : define( 'WP_DEBUG', true ); Cela vous per­met­tra d’afficher les erreurs à l’écran (à désac­ti­ver une fois la répa­ra­tion effectuée).
   • → Voir notre guide sur le fichier wp-config.php

Ressource utile

→ Docu­men­ta­tion Word­Press – FAQ Dépannage

Erreur “Dossier de destination déjà existant”

Symptômes

• Lors de l’installation d’un thème ou d’une exten­sion, Word­Press affiche :
  « Échec de l’installation : le dos­sier de des­ti­na­tion existe déjà. »
• L’installation est inter­rom­pue et l’élément ne s’active pas

Causes probables

• Une ten­ta­tive d’installation pré­cé­dente a échoué partiellement
• Le dos­sier du thème ou plu­gin existe déjà dans /wp-content/themes/ ou /wp-content/plugins/
• L’extension ou le thème a été ins­tal­lé manuel­le­ment sans sup­pres­sion préalable

Solutions de base

1. Sup­pri­mer manuel­le­ment le dos­sier concerné
   • Connec­tez-vous via FTP ou avec le ges­tion­naire de fichiers
   • Ren­dez-vous dans le dos­sier /wp-content/themes/ ou /wp-content/plugins/
   • Sup­pri­mez le dos­sier por­tant le même nom que celui que vous essayiez d’installer
2. Relan­cer l’installation dans WordPress
   • Une fois le dos­sier sup­pri­mé, retour­nez dans l’administration Word­Press et relan­cez l’installation du thème ou de l’extension.

→ Si vous hési­tez sur le dos­sier à sup­pri­mer, vous pou­vez le renom­mer pour évi­ter tout risque (ex. : plugin-nom_old) avant de réessayer.

Ressource utile

→ Docu­men­ta­tion Word­Press – Erreurs fréquentes

Le site reste bloqué en mode maintenance

Symptômes

• Le site affiche le mes­sage :
  « Brie­fly una­vai­lable for sche­du­led main­te­nance. Check back in a minute. »
• L’administration est éga­le­ment inaccessible
• Le mes­sage per­siste plu­sieurs minutes, voire indéfiniment

Causes probables

• Une mise à jour (Word­Press, thème ou exten­sion) a été interrompue
• Le fichier .maintenance créé auto­ma­ti­que­ment par Word­Press n’a pas été supprimé

Solutions de base

1. Sup­pri­mer le fichier .maintenance à la racine du site
   • Connec­tez-vous via FTP ou avec le ges­tion­naire de fichiers
   • Repé­rez le fichier .maintenance à la racine du site (au même niveau que wp-config.php)
     • Atten­tion : il s’a­git d’un fichier caché (com­men­çant par un point). Il faut donc affi­cher les fichiers mas­qués dans votre ges­tion­naire de fichiers ou votre client ftp.
   • Sup­pri­mez ce fichier
     Le site devrait rede­ve­nir immé­dia­te­ment accessible.
2. Relan­cer manuel­le­ment la mise à jour si nécessaire
   • Une fois le site à nou­veau en ligne, véri­fiez si la mise à jour a bien été appliquée. 
   • Si ce n’est pas le cas, relan­cez-la depuis l’administration.

Ressource utile

→ Docu­men­ta­tion Word­Press – Erreurs fréquentes

Erreur 503 – Service temporairement indisponible

Symptômes

• Le site affiche une page avec le mes­sage :
  « 503 Ser­vice Una­vai­lable » ou « Ser­vice tem­po­rai­re­ment indisponible »
• Le front-end est inac­ces­sible, par­fois aus­si l’administration
• L’erreur peut appa­raître de manière intermittente

Causes probables

• Sur­charge tem­po­raire du serveur
• Une exten­sion ou un thème pro­voque un dys­fonc­tion­ne­ment critique
• Un conflit lors d’une mise à jour
• Un blo­cage côté ser­veur (ex. Mod­Se­cu­ri­ty, anti-DDoS)

Solutions de base

1. Désac­ti­ver les exten­sions temporairement
   • Connec­tez-vous via FTP ou le ges­tion­naire de fichiers, renom­mez le dos­sier /wp-content/plugins/ pour désac­ti­ver l’ensemble des extensions.
   • Rechar­gez le site pour véri­fier si le pro­blème disparaît.
2. Bas­cu­ler tem­po­rai­re­ment sur un thème par défaut
   • Si l’erreur per­siste, renom­mez le dos­sier du thème actif dans /wp-content/themes/. Word­Press uti­li­se­ra auto­ma­ti­que­ment un thème de secours (si disponible).
3. Véri­fier si le ser­veur est en surcharge
   • Si vous avez accès à l’espace client de votre héber­geur, consul­tez l’état des res­sources (CPU, mémoire, processus).
   • Cer­tains outils d’administration comme cPa­nel per­mettent de voir si le compte a dépas­sé ses limites.
4. Contac­ter l’hébergeur
   • Si vous sus­pec­tez un blo­cage ser­veur (filtre de sécu­ri­té, limite atteinte, main­te­nance), contac­tez le sup­port pour obte­nir un diag­nos­tic précis.

Ressource utile

→ FAQ o2switch – Page blanche ou erreur 500
→ Blog o2switch – Com­prendre les pages d’erreurs HTTP

Problèmes liés aux extensions ou aux thèmes

Symptômes

• Le site plante après l’activation d’un plu­gin ou d’un thème
• Cer­taines fonc­tion­na­li­tés cessent de fonc­tion­ner (for­mu­laires, paniers, images, etc.)
• Des erreurs PHP ou JavaS­cript appa­raissent à l’écran ou dans la console du navigateur
• Une mise à jour déclenche une erreur fatale

Causes probables

• Conflit entre deux exten­sions ou entre une exten­sion et le thème actif
• Plu­gin mal codé, obso­lète ou incom­pa­tible avec la ver­sion actuelle de WordPress
• Thème non main­te­nu ou modi­fié manuellement
• Exten­sion ou thème incom­pa­tible avec la ver­sion de PHP uti­li­sée sur le serveur

Solutions de base

1. Désac­ti­ver les exten­sions une à une
   • Connec­tez-vous via FTP ou le ges­tion­naire de fichiers
   • Renom­mez le dos­sier /wp-content/plugins/ pour désac­ti­ver toutes les extensions
   • Puis réac­ti­vez-les une à une depuis l’administration pour iden­ti­fier celle qui pose problème
2. Tes­ter avec un thème Word­Press par défaut
   • Acti­vez un thème de base comme Twen­ty Twen­ty-Four pour voir si le pro­blème disparaît.
   • Cela per­met d’écarter une incom­pa­ti­bi­li­té côté thème.
3. Véri­fier la ver­sion de PHP utilisée
   • Si le pro­blème per­siste, assu­rez-vous que la ver­sion de PHP uti­li­sée par votre héber­ge­ment est bien com­pa­tible avec Word­Press et les exten­sions installées.
   • Chez o2switch, vous pou­vez chan­ger la ver­sion de PHP depuis le cPa­nel, avec l’outil « Sélec­tion­ner une ver­sion de PHP ».
4. Mettre à jour Word­Press, les thèmes et les extensions
   • Des bugs peuvent pro­ve­nir d’extensions ou de thèmes non à jour. 
   • Veillez à effec­tuer les mises à jour régu­liè­re­ment, après avoir effec­tué une sauvegarde.
5. Sup­pri­mer les exten­sions non utilisées
   • Moins vous avez d’extensions, moins vous pre­nez de risques. Sup­pri­mez celles qui ne sont pas ou plus nécessaires.

Ressources utiles

→ Blog o2switch – Exten­sions Word­Press : le guide com­plet
→ Blog o2switch – Les thèmes dans WordPress

Erreurs dues à une mise à jour incomplète

Symptômes

• Le site plante juste après une mise à jour (Word­Press, thème ou plugin)
• Cer­taines fonc­tion­na­li­tés ne répondent plus
• Des erreurs s’affichent en lien avec des fichiers manquants
• Le mes­sage d’erreur men­tionne par­fois un fichier PHP introuvable

Causes probables

• L’opération de mise à jour a été inter­rom­pue (connexion instable, timeout, espace disque insuffisant…)
• Des fichiers n’ont pas été cor­rec­te­ment télé­char­gés ou écrasés
• Un plu­gin ou un thème est par­tiel­le­ment mis à jour

Solutions de base

1. Réins­tal­ler Word­Press manuel­le­ment
   Télé­char­gez la der­nière ver­sion de Word­Press sur fr​.word​press​.org, puis :
   • Sup­pri­mez les dos­siers /wp-admin/ et /wp-includes/
   • Envoyez les nou­veaux dos­siers par FTP
   • Ne tou­chez pas au dos­sier /wp-content/ ni au fichier wp-config.php
     Cela per­met de réta­blir tous les fichiers essen­tiels sans impac­ter vos contenus.
   • Voir dans notre article sur les mises à jour : le cha­pitre : Méthode 2 : mise à jour manuelle (via FTP)
2. Sup­pri­mer et réins­tal­ler le thème ou plu­gin concerné
   • Si l’erreur est liée à un thème ou une exten­sion, sup­pri­mez leur dos­sier dans /wp-content/themes/ ou /wp-content/plugins/ puis réins­tal­lez-les depuis l’interface WordPress.
3. Véri­fier l’espace disque disponible
   • Un manque d’espace peut blo­quer les mises à jour. Véri­fiez dans votre espace client si vous avez atteint la limite d’hébergement.

Ressource utile

→ Blog o2switch – Mettre à jour WordPress

En résumé : mieux vaut prévenir que subir

Les erreurs Word­Press sont cou­rantes, mais la plu­part peuvent être réso­lues rapi­de­ment lorsqu’on connaît les bons réflexes. Un fichier .htaccess cor­rom­pu, une exten­sion instable, une base mal confi­gu­rée… autant de causes qu’il est pos­sible d’identifier avec méthode.

→ Gardez en tête ces bonnes pratiques pour limiter les risques :

• Effec­tuer des sau­ve­gardes régulières
• Mettre à jour Word­Press, les exten­sions et les thèmes avec pru­dence
• Uti­li­ser des exten­sions fiables, bien notées et maintenues
• Tra­vailler dans un envi­ron­ne­ment de test avant les grosses modifications
• Sur­veiller l’espace disque et les res­sources serveur

Et si vous ne parvenez pas à résoudre un problème par vous-même, n’hésitez pas à consulter :

• La FAQ o2switch – Débo­guer une page blanche ou une erreur 500
• La docu­men­ta­tion offi­cielle Word­Press – FAQ Dépannage
• Nos autres articles dédiés sur le blog o2switch

Un grand mer­ci à l’équipe de docu­men­ta­tion de Word­Press en fran­çais pour la tra­duc­tion et la mise à jour régu­lière de la docu­men­ta­tion offi­cielle ❤️. Un tra­vail béné­vole essen­tiel pour aider les uti­li­sa­teurs Word­Press à mieux com­prendre et gérer leur site. Vous pou­vez, vous aus­si, quel que soit votre niveau, par­ti­ci­per à l’écriture et à la tra­duc­tion de la docu­men­ta­tion de Word­Press.
Pour en savoir plus : → Rejoindre l’équipe de docu­men­ta­tion de Word­Press en français