Vous ouvrez votre site et tombez sur ce message : « Erreur lors de la connexion à la base de données ». Ou en anglais : « Error Establishing a Database Connection ». Pas de tableau de bord, pas d’accès, rien. C’est l’une des erreurs WordPress les plus stressantes parce qu’elle touche directement le cœur de votre site. Sans base de données, WordPress ne peut rien afficher. Ni vos pages, ni vos articles, ni votre boutique.
La bonne nouvelle : dans la grande majorité des cas, la cause est identifiable en quelques minutes. Et la correction, souvent plus simple qu’on ne le craint.
Comprendre l’erreur de connexion à la base de données
Signification et impact de l’erreur
WordPress fonctionne avec deux composants distincts : des fichiers PHP sur le serveur, et une base de données MySQL qui stocke tout le contenu (articles, pages, réglages, comptes utilisateurs). Ces deux composants communiquent en permanence. Quand cette communication échoue, WordPress ne peut rien faire. Il affiche l’erreur de connexion et s’arrête là.
L’impact est total. Vos visiteurs voient un message d’erreur ou une page blanche. Vous n’avez plus accès à votre tableau de bord. Si vous avez un site e-commerce, chaque minute de panne se traduit directement en ventes perdues. La priorité est donc de diagnostiquer vite et de corriger au plus tôt.
Scénarios fréquents d’échec de connexion
Plusieurs situations peuvent provoquer cette erreur. Les voici, de la plus courante à la plus rare.
Des identifiants de base de données incorrects : le nom de la base de données, le nom d’utilisateur ou le mot de passe renseignés dans le fichier wp-config.php ne correspondent plus à ceux configurés sur le serveur. Ça arrive après une migration, un changement d’hébergeur, ou une modification manuelle malencontreuse.
Un serveur MySQL qui ne répond plus : la base de données existe et les identifiants sont corrects, mais le service MySQL de votre hébergeur est temporairement en panne ou surchargé. C’est hors de votre contrôle direct, mais ça se vérifie rapidement.
Une base de données corrompue : suite à une mise à jour mal passée, un crash serveur ou un piratage, certaines tables de la base de données peuvent être endommagées. WordPress ne peut plus lire les données dont il a besoin.
Un dépassement de quota : sur certains hébergements mutualisés, une limite de connexions simultanées à la base de données est fixée. En cas de pic de trafic ou d’un plugin mal optimisé qui multiplie les requêtes, cette limite peut être atteinte et WordPress se retrouve dans l’impossibilité d’ouvrir une nouvelle connexion.
Diagnostic du problème
Vérification des identifiants dans wp-config.php
C’est la première vérification à faire, et elle résout le problème dans la majorité des cas. Via FTP, accédez à la racine de votre site WordPress et ouvrez le fichier wp-config.php avec un éditeur de texte. Cherchez ces quatre lignes.
define( 'DB_NAME', 'nom_de_votre_base' );
define( 'DB_USER', 'nom_utilisateur' );
define( 'DB_PASSWORD', 'mot_de_passe' );
define( 'DB_HOST', 'localhost' );Ces quatre valeurs doivent correspondre exactement à celles configurées dans votre hébergeur. Pour les vérifier, connectez-vous à l’interface de votre hébergeur (cPanel, Plesk, ou autre) et cherchez la section « Bases de données MySQL ». Vous y trouverez le nom de la base et le nom d’utilisateur associé. Le mot de passe, lui, ne s’affiche généralement pas, mais vous pouvez en créer un nouveau depuis cette interface et le mettre à jour dans wp-config.php.
La valeur DB_HOST est presque toujours localhost, sauf sur certains hébergements spécifiques qui utilisent une adresse de serveur différente. En cas de doute, vérifiez la documentation de votre hébergeur ou contactez son support.
Analyse des logs d’erreur et du serveur
Si les identifiants sont corrects et que l’erreur persiste, il faut creuser plus loin. Activez le mode debug de WordPress en ajoutant ces lignes dans wp-config.php, juste 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 );Les erreurs seront enregistrées dans wp-content/debug.log. Si le message indique « Access denied for user », le problème vient des identifiants ou des droits de l’utilisateur sur la base de données. Si le message indique « Can’t connect to MySQL server », le serveur MySQL lui-même est inaccessible, ce qui pointe vers un problème côté hébergeur.
Consultez aussi les logs d’erreur de votre serveur, accessibles depuis l’interface de votre hébergeur. Un pic d’erreurs MySQL à une heure précise peut indiquer un crash du service ou un dépassement de quota.
Solutions et réparations
Correction manuelle des paramètres de connexion
Si le diagnostic confirme un problème d’identifiants, la correction est directe. Mettez à jour les valeurs dans wp-config.php pour qu’elles correspondent à celles de votre hébergeur, sauvegardez le fichier, et rechargez votre site. Dans la plupart des cas, ça repart immédiatement.
Si vous venez de changer d’hébergeur ou de migrer votre site, vérifiez aussi que la base de données a bien été importée sur le nouveau serveur. Une base de données vide ou incomplète génère exactement la même erreur que des identifiants incorrects.
Utilisation des outils de diagnostic et de réparation
WordPress intègre un outil natif de réparation de base de données, utile quand des tables sont corrompues. Pour l’activer, ajoutez cette ligne dans wp-config.php.
define( 'WP_ALLOW_REPAIR', true );Puis rendez-vous sur l’URL suivante depuis votre navigateur, en remplaçant votresite.fr par votre domaine.
https://votresite.fr/wp-admin/maint/repair.phpCette page vous propose deux options : réparer la base de données, ou réparer et optimiser. Choisissez la première option. Si des tables corrompues sont détectées, WordPress tentera de les réparer automatiquement. Une fois l’opération terminée, supprimez impérativement la ligne WP_ALLOW_REPAIR de votre wp-config.php : cette page est accessible sans authentification et ne doit pas rester active.
Pour aller plus loin, phpMyAdmin (accessible depuis votre hébergeur) permet de vérifier et réparer chaque table individuellement. Sélectionnez toutes les tables de votre base de données, puis choisissez l’opération « Réparer la table » dans le menu déroulant.
Si le serveur MySQL est en panne côté hébergeur, vous n’avez pas d’autre option que de contacter le support de votre hébergeur. Vérifiez d’abord leur page de statut ou leur compte sur les réseaux sociaux pour voir si un incident est en cours. La plupart des hébergeurs sérieux communiquent rapidement sur ces situations.
Prévention et bonnes pratiques
Sauvegardes régulières et mises à jour
Une base de données corrompue est beaucoup plus simple à gérer quand vous avez une sauvegarde récente. La restauration d’une sauvegarde saine prend quelques minutes et garantit un résultat propre, là où la réparation manuelle peut être longue et incertaine si les dommages sont importants.
Configurez des sauvegardes automatiques quotidiennes de votre base de données, stockées hors de votre serveur principal. UpdraftPlus, BlogVault ou les sauvegardes incluses dans certaines offres d’hébergement font très bien ce travail. Vérifiez aussi régulièrement que ces sauvegardes sont complètes et restaurables.
Conseils pour éviter de futures erreurs de connexion
Quelques habitudes simples réduisent significativement le risque de se retrouver face à cette erreur.
— Ne modifiez jamais wp-config.php sans en avoir fait une copie au préalable. Une simple faute de frappe dans ce fichier suffit à couper l’accès à toute l’installation.
— Avant toute migration, notez précisément les identifiants de base de données de destination et vérifiez-les une fois la migration effectuée, avant de rediriger le nom de domaine.
— Nettoyez régulièrement votre base de données avec un outil comme WP-Optimize pour supprimer les révisions d’articles, les commentaires en spam et les données transitoires accumulées. Une base de données allégée est plus rapide et moins sujette aux corruptions.
— Choisissez un hébergeur qui propose un monitoring de la base de données et des alertes en cas de problème. Les hébergeurs spécialisés WordPress intègrent souvent ces fonctionnalités nativement.
Si vous préférez ne pas gérer ces aspects techniques vous-même, c’est exactement ce que couvre notre service de maintenance WordPress : surveillance de la base de données, sauvegardes vérifiées, et intervention rapide dès qu’un problème se manifeste.
