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

Même si WordPress est réputé pour sa simplicité, il n’est pas rare de rencontrer des erreurs sur son site : page blanche, erreur 500, blocage en mode maintenance… Ces problèmes peuvent survenir après une mise à jour, l’ajout d’une extension ou une mauvaise manipulation.

Cette checklist vous aidera à identifier rapidement les erreurs les plus courantes et à comprendre où chercher pour les corriger efficacement. Pour chaque erreur listée, nous vous indiquons les symptômes, les causes probables, des solutions de base et, si nécessaire, une ressource utile pour aller plus loin.

Utilisez le sommaire de l’article pour accéder directement à l’erreur qui vous concerne.

L’écran blanc de la mort (WSOD)

Symptômes

• Le site (ou l’administration) affiche une page totalement blanche
• Aucun message d’erreur n’apparaît
• Parfois visible uniquement sur certaines pages, ou seulement côté admin

Causes probables

• Une erreur PHP dans un thème ou une extension
• Un problème de mémoire insuffisante
• Un fichier corrompu ou mal écrit

Solutions de base

1. Activer le mode debug de WordPress
   • Dans le fichier wp-config.php, ajoutez ou modifiez la ligne suivante : define( 'WP_DEBUG', true ); Cela permet de faire apparaître les erreurs PHP à l’écran (à désactiver une fois le problème résolu).
   • → Voir : Configurer wp-config.php dans WordPress
2. Désactiver les extensions via FTP ou le gestionnaire de fichiers
   • Renommez temporairement le dossier /wp-content/plugins/ pour voir si le site revient.
3. Basculer sur un thème par défaut
   • Si l’erreur persiste, renommez le dossier de votre thème actif (/wp-content/themes/nom-du-theme) pour forcer WordPress à charger un thème par défaut comme Twenty Twenty-Four.

Ressource utile

→ FAQ o2switch – Déboguer une page blanche ou une erreur 500

Erreur 500 (Erreur interne du serveur)

Symptômes

• Une page affiche « Erreur 500 – Internal Server Error »
• Le site devient inaccessible, y compris l’administration
• L’erreur peut être intermittente ou permanente

Causes probables

• Un fichier .htaccess corrompu
• Une extension ou un thème incompatible
• Une limite de ressources atteinte (mémoire PHP, temps d’exécution…)
• Une erreur temporaire côté serveur (surcharge, maintenance, mauvaise configuration)

Solutions de base

1. Renommer le fichier .htaccess
   • Accédez à la racine du site via FTP ou le gestionnaire de fichiers, puis renommez .htaccess en .htaccess_old.
   • Ensuite, reconnectez-vous à l’administration et rendez-vous dans Réglages > Permaliens pour en générer un nouveau.
2. Augmenter la mémoire PHP dans wp-config.php
   • Ajoutez la ligne suivante avant /* That's all, stop editing! */ :
     define( 'WP_MEMORY_LIMIT', '256M' );
3. Désactiver les extensions
   • Comme pour le WSOD, renommez temporairement le dossier /wp-content/plugins/ pour tester si une extension est en cause.
4. Contacter le support si le problème persiste
   • Si aucune solution ne fonctionne, il est possible qu’un incident serveur soit en cause. Dans ce cas, contactez votre hébergeur pour vérifier.

Ressource utile

→ Blog o2switch – Comprendre les pages d’erreurs HTTP
→ FAQ o2switch – Déboguer une erreur 500

Erreur de connexion à la base de données

Symptômes

• Message affiché : « Erreur de connexion à la base de données »
• Le site et l’interface d’administration sont tous deux inaccessibles
• Parfois, un simple rafraîchissement ne suffit pas à résoudre le problème

Causes probables

• Mauvais identifiants dans le fichier wp-config.php
• Serveur de base de données temporairement inaccessible
• Base de données supprimée ou déplacée

Solutions de base

1. Vérifier les identifiants de connexion dans wp-config.php
   • Assurez-vous que les constantes suivantes correspondent bien aux identifiants de votre base de donné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 modifier ce fichier ? Consultez notre guide : Configurer le fichier wp-config.php dans WordPress
2. Vérifier que la base de données est accessible et cohérente
   • Connectez-vous à phpMyAdmin depuis votre espace d’hébergement.
   • Vérifiez que :
     • le nom de la base affiché correspond bien à celui indiqué dans wp-config.php (DB_NAME)
     • la base contient bien des tables WordPress (dont wp_options, wp_users, etc.)
     • le préfixe des tables correspond à celui indiqué dans $table_prefix de votre fichier wp-config.php
   • Si la base n’existe pas, a été supprimée ou renommée, ou si elle ne contient pas les bonnes tables, cela peut expliquer l’erreur de connexion.
3. Contacter l’hébergeur
   • Si les identifiants sont corrects et que la base semble en ligne, il peut s’agir d’un incident temporaire côté serveur. N’hésitez pas à contacter le support.

Ressource utile

→ Documentation WordPress – FAQ Dépannage

Erreur 403 – Accès interdit

Symptômes

• Un message du type « 403 Forbidden » s’affiche à la place d’une page du site
• Parfois l’erreur concerne uniquement l’administration ou une page spécifique
• Le site peut rester accessible mais certaines actions sont bloquées

Causes probables

• Règles restrictives dans le fichier .htaccess
• Permissions de fichiers incorrectes
• Extension de sécurité (type Wordfence, Solid Security…) mal configurée
• Blocage par le serveur ou une protection web (ex. ModSecurity, pare-feu)

Solutions de base

1. Vérifier ou remplacer le fichier .htaccess
   • Renommez le fichier .htaccess à la racine du site (.htaccess_old), puis connectez-vous à WordPress > Réglages > Permaliens et cliquez sur « Enregistrer les modifications » pour en générer un nouveau.
2. Vérifier les permissions des fichiers
   • Assurez-vous que :
     • Les dossiers ont les permissions 755
     • Les fichiers ont les permissions 644
     • Des permissions trop restrictives peuvent générer une erreur 403.
3. Désactiver temporairement les extensions de sécurité
   • Via FTP ou le gestionnaire de fichiers, renommez le dossier de l’extension concernée (par exemple wordfence devient wordfence_off) dans /wp-content/plugins/.
4. Contacter le support en cas de doute
   • Si vous soupçonnez un blocage serveur (ex. ModSecurity), votre hébergeur peut vous aider à lever la restriction ou identifier la règle en cause.

Ressource utile

→ Blog o2switch – Comprendre les pages d’erreurs HTTP

Erreur 404 sur toutes les pages sauf l’accueil

Symptômes

• L’accueil s’affiche correctement, mais toutes les autres pages (articles, catégories, etc.) renvoient une erreur 404
• Le contenu existe bien dans l’administration mais n’est pas accessible publiquement

Causes probables

• Problème de réécriture d’URL (permalien)
• Fichier .htaccess manquant ou incorrect
• Mauvaise configuration du serveur web

Solutions de base

1. Réinitialiser les permaliens dans WordPress
   • Allez dans Réglages > Permaliens, puis cliquez simplement sur « Enregistrer les modifications » (même sans rien modifier).
   • Cela permet de régénérer les règles de réécriture.
2. Renommer le fichier .htaccess et rafraîchir les permaliens
   • Accédez à la racine du site via FTP ou le gestionnaire de fichiers, renommez .htaccess en .htaccess_old, puis répétez l’étape précédente (réinitialiser les permaliens) pour générer un nouveau fichier .htaccess propre.

Ressource utile

→ Documentation WordPress – Erreurs fréquentes

Le site rencontre des difficultés techniques

Symptômes

• Message affiché à l’écran : « Le site rencontre des difficultés techniques. Veuillez vérifier votre boîte de réception… »
• Un e-mail est envoyé à l’administrateur avec un lien pour accéder au mode de récupération
• L’erreur peut concerner le front-end, l’administration ou les deux

Causes probables

• Une extension ou un thème provoque une erreur fatale
• Un fichier PHP mal modifié ou corrompu
• Un conflit survenu après une mise à jour

Solutions de base

1. Utiliser le mode de récupération de WordPress
   • Si vous avez reçu l’e-mail de WordPress (à l’adresse admin du site), cliquez sur le lien fourni. Il vous permettra d’accéder temporairement à l’administration avec certaines extensions désactivées, le temps de corriger l’erreur.
2. Désactiver manuellement les extensions ou le thème fautif
   • Si vous n’avez pas reçu l’e-mail ou qu’il ne fonctionne pas :
     • Connectez-vous via FTP ou le gestionnaire de fichiers
     • Renommez le dossier /wp-content/plugins/ pour désactiver toutes les extensions
     • Si nécessaire, renommez le dossier du thème actif dans /wp-content/themes/ pour forcer le retour à un thème par défaut
3. Activer le mode debug pour identifier l’erreur
   • Dans le fichier wp-config.php, ajoutez ou modifiez la ligne suivante : define( 'WP_DEBUG', true ); Cela vous permettra d’afficher les erreurs à l’écran (à désactiver une fois la réparation effectuée).
   • → Voir notre guide sur le fichier wp-config.php

Ressource utile

→ Documentation WordPress – FAQ Dépannage

Erreur “Dossier de destination déjà existant”

Symptômes

• Lors de l’installation d’un thème ou d’une extension, WordPress affiche :
  « Échec de l’installation : le dossier de destination existe déjà. »
• L’installation est interrompue et l’élément ne s’active pas

Causes probables

• Une tentative d’installation précédente a échoué partiellement
• Le dossier du thème ou plugin existe déjà dans /wp-content/themes/ ou /wp-content/plugins/
• L’extension ou le thème a été installé manuellement sans suppression préalable

Solutions de base

1. Supprimer manuellement le dossier concerné
   • Connectez-vous via FTP ou avec le gestionnaire de fichiers
   • Rendez-vous dans le dossier /wp-content/themes/ ou /wp-content/plugins/
   • Supprimez le dossier portant le même nom que celui que vous essayiez d’installer
2. Relancer l’installation dans WordPress
   • Une fois le dossier supprimé, retournez dans l’administration WordPress et relancez l’installation du thème ou de l’extension.

→ Si vous hésitez sur le dossier à supprimer, vous pouvez le renommer pour éviter tout risque (ex. : plugin-nom_old) avant de réessayer.

Ressource utile

→ Documentation WordPress – Erreurs fréquentes

Le site reste bloqué en mode maintenance

Symptômes

• Le site affiche le message :
  « Briefly unavailable for scheduled maintenance. Check back in a minute. »
• L’administration est également inaccessible
• Le message persiste plusieurs minutes, voire indéfiniment

Causes probables

• Une mise à jour (WordPress, thème ou extension) a été interrompue
• Le fichier .maintenance créé automatiquement par WordPress n’a pas été supprimé

Solutions de base

1. Supprimer le fichier .maintenance à la racine du site
   • Connectez-vous via FTP ou avec le gestionnaire de fichiers
   • Repérez le fichier .maintenance à la racine du site (au même niveau que wp-config.php)
     • Attention : il s’agit d’un fichier caché (commençant par un point). Il faut donc afficher les fichiers masqués dans votre gestionnaire de fichiers ou votre client ftp.
   • Supprimez ce fichier
     Le site devrait redevenir immédiatement accessible.
2. Relancer manuellement la mise à jour si nécessaire
   • Une fois le site à nouveau en ligne, vérifiez si la mise à jour a bien été appliquée.
   • Si ce n’est pas le cas, relancez-la depuis l’administration.

Ressource utile

→ Documentation WordPress – Erreurs fréquentes

Erreur 503 – Service temporairement indisponible

Symptômes

• Le site affiche une page avec le message :
  « 503 Service Unavailable » ou « Service temporairement indisponible »
• Le front-end est inaccessible, parfois aussi l’administration
• L’erreur peut apparaître de manière intermittente

Causes probables

• Surcharge temporaire du serveur
• Une extension ou un thème provoque un dysfonctionnement critique
• Un conflit lors d’une mise à jour
• Un blocage côté serveur (ex. ModSecurity, anti-DDoS)

Solutions de base

1. Désactiver les extensions temporairement
   • Connectez-vous via FTP ou le gestionnaire de fichiers, renommez le dossier /wp-content/plugins/ pour désactiver l’ensemble des extensions.
   • Rechargez le site pour vérifier si le problème disparaît.
2. Basculer temporairement sur un thème par défaut
   • Si l’erreur persiste, renommez le dossier du thème actif dans /wp-content/themes/. WordPress utilisera automatiquement un thème de secours (si disponible).
3. Vérifier si le serveur est en surcharge
   • Si vous avez accès à l’espace client de votre hébergeur, consultez l’état des ressources (CPU, mémoire, processus).
   • Certains outils d’administration comme cPanel permettent de voir si le compte a dépassé ses limites.
4. Contacter l’hébergeur
   • Si vous suspectez un blocage serveur (filtre de sécurité, limite atteinte, maintenance), contactez le support pour obtenir un diagnostic précis.

Ressource utile

→ FAQ o2switch – Page blanche ou erreur 500
→ Blog o2switch – Comprendre 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 plugin ou d’un thème
• Certaines fonctionnalités cessent de fonctionner (formulaires, paniers, images, etc.)
• Des erreurs PHP ou JavaScript apparaissent à l’écran ou dans la console du navigateur
• Une mise à jour déclenche une erreur fatale

Causes probables

• Conflit entre deux extensions ou entre une extension et le thème actif
• Plugin mal codé, obsolète ou incompatible avec la version actuelle de WordPress
• Thème non maintenu ou modifié manuellement
• Extension ou thème incompatible avec la version de PHP utilisée sur le serveur

Solutions de base

1. Désactiver les extensions une à une
   • Connectez-vous via FTP ou le gestionnaire de fichiers
   • Renommez le dossier /wp-content/plugins/ pour désactiver toutes les extensions
   • Puis réactivez-les une à une depuis l’administration pour identifier celle qui pose problème
2. Tester avec un thème WordPress par défaut
   • Activez un thème de base comme Twenty Twenty-Four pour voir si le problème disparaît.
   • Cela permet d’écarter une incompatibilité côté thème.
3. Vérifier la version de PHP utilisée
   • Si le problème persiste, assurez-vous que la version de PHP utilisée par votre hébergement est bien compatible avec WordPress et les extensions installées.
   • Chez o2switch, vous pouvez changer la version de PHP depuis le cPanel, avec l’outil « Sélectionner une version de PHP ».
4. Mettre à jour WordPress, les thèmes et les extensions
   • Des bugs peuvent provenir d’extensions ou de thèmes non à jour.
   • Veillez à effectuer les mises à jour régulièrement, après avoir effectué une sauvegarde.
5. Supprimer les extensions non utilisées
   • Moins vous avez d’extensions, moins vous prenez de risques. Supprimez celles qui ne sont pas ou plus nécessaires.

Ressources utiles

→ Blog o2switch – Extensions WordPress : le guide complet
→ 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 (WordPress, thème ou plugin)
• Certaines fonctionnalités ne répondent plus
• Des erreurs s’affichent en lien avec des fichiers manquants
• Le message d’erreur mentionne parfois un fichier PHP introuvable

Causes probables

• L’opération de mise à jour a été interrompue (connexion instable, timeout, espace disque insuffisant…)
• Des fichiers n’ont pas été correctement téléchargés ou écrasés
• Un plugin ou un thème est partiellement mis à jour

Solutions de base

1. Réinstaller WordPress manuellement
   Téléchargez la dernière version de WordPress sur fr.wordpress.org, puis :
   • Supprimez les dossiers /wp-admin/ et /wp-includes/
   • Envoyez les nouveaux dossiers par FTP
   • Ne touchez pas au dossier /wp-content/ ni au fichier wp-config.php
     Cela permet de rétablir tous les fichiers essentiels sans impacter vos contenus.
   • Voir dans notre article sur les mises à jour : le chapitre : Méthode 2 : mise à jour manuelle (via FTP)
2. Supprimer et réinstaller le thème ou plugin concerné
   • Si l’erreur est liée à un thème ou une extension, supprimez leur dossier dans /wp-content/themes/ ou /wp-content/plugins/ puis réinstallez-les depuis l’interface WordPress.
3. Vérifier l’espace disque disponible
   • Un manque d’espace peut bloquer les mises à jour. Vérifiez 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 WordPress sont courantes, mais la plupart peuvent être résolues rapidement lorsqu’on connaît les bons réflexes. Un fichier .htaccess corrompu, une extension instable, une base mal configurée… autant de causes qu’il est possible d’identifier avec méthode.

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

• Effectuer des sauvegardes régulières
• Mettre à jour WordPress, les extensions et les thèmes avec prudence
• Utiliser des extensions fiables, bien notées et maintenues
• Travailler dans un environnement de test avant les grosses modifications
• Surveiller l’espace disque et les ressources 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éboguer une page blanche ou une erreur 500
• La documentation officielle WordPress – FAQ Dépannage
• Nos autres articles dédiés sur le blog o2switch

Un grand merci à l’équipe de documentation de WordPress en français pour la traduction et la mise à jour régulière de la documentation officielle ❤️. Un travail bénévole essentiel pour aider les utilisateurs WordPress à mieux comprendre et gérer leur site. Vous pouvez, vous aussi, quel que soit votre niveau, participer à l’écriture et à la traduction de la documentation de WordPress.
Pour en savoir plus : → Rejoindre l’équipe de documentation de WordPress en français