Pourquoi cette erreur apparaît et comment la réparer ?

Que signifie « Error establishing a database connection » ?

• les articles ;
• les pages ;
• les utilisateurs ;
• les réglages ;
• les commentaires ;
• les données des extensions.

Quelles sont les causes les plus fréquentes ?

1. Les identifiants de la base sont incorrects

2. L’utilisateur n’a plus les bons privilèges

3. Le serveur MySQL ou MariaDB est indisponible

4. La base de données rencontre un problème

Comment réparer l’erreur WordPress étape par étape ?

Étape 1 : tester la connexion à la base de données

Étape 2 : vérifier le fichier wp-config.php

Vérifiez particulièrement DB_HOST

Vérifiez également le mot de passe

Étape 3 : vérifier les droits de l’utilisateur MySQL

• le nom de la base ;
• le nom de l’utilisateur ;
• l’association entre l’utilisateur et la base ;
• les privilèges accordés.

Étape 4 : vérifier l’état de MySQL ou MariaDB

Une limite de connexions peut-elle provoquer cette erreur ?

• un pic de trafic ;
• une extension défaillante ;
• une requête trop longue ;
• des ressources serveur insuffisantes ;
• une mauvaise configuration de MySQL.

Étape 5 : réparer la base de données WordPress

• Repair Database
• Repair and Optimize Database

Étape 6 : vérifier les extensions WordPress

Étape 7 : vérifier le thème actif

Étape 8 : vérifier les fichiers WordPress

Que faire si l’erreur apparaît après une migration ?

• le nom de la base ;
• l’utilisateur MySQL ;
• le mot de passe ;
• DB_HOST ;
• les privilèges de l’utilisateur ;
• les informations de connexion du nouvel hébergement.

Comment éviter cette erreur à l’avenir ?

Effectuez des sauvegardes régulières

• la base de données ;
• les fichiers WordPress ;
• les médias ;
• les thèmes ;
• les extensions.

Surveillez les ressources du serveur

• la mémoire RAM ;
• le processeur ;
• l’espace disque ;
• les connexions MySQL ;
• les temps de réponse.

Maintenez WordPress à jour

• WordPress ;
• les extensions ;
• les thèmes ;
• PHP ;
• MySQL ou MariaDB.

Choisissez un hébergement adapté

Et si le problème persiste ?

• des erreurs MySQL ;
• des problèmes de permissions ;
• des limites de ressources ;
• des erreurs PHP ;
• des connexions refusées.

Les erreurs à éviter pendant le dépannage

1. sauvegardez les données ;
2. testez la connexion à la base ;
3. vérifiez wp-config.php ;
4. contrôlez les privilèges ;
5. vérifiez MySQL ou MariaDB ;
6. analysez les journaux ;
7. testez les extensions ;
8. vérifiez ensuite les fichiers WordPress.

Conclusion

À lire également

Votre site WordPress affiche soudainement un message inquiétant :

Error establishing a database connection

Le tableau de bord peut également devenir inaccessible. Dans certains cas, toutes les pages du site sont concernées.

Pas de panique. Cette erreur indique surtout que WordPress ne parvient plus à communiquer avec sa base de données.

La cause peut être simple. Un mauvais identifiant suffit parfois à provoquer le problème. Dans d’autres cas, le serveur MySQL ou MariaDB peut être indisponible.

Dans ce guide, nous allons identifier la cause. Ensuite, nous verrons comment rétablir l’accès étape par étape.

WordPress utilise une base de données pour stocker une grande partie des informations du site.

On y retrouve notamment :

Lorsque WordPress ne peut plus accéder à cette base, il ne peut plus récupérer ces informations.

Le site peut alors afficher :

Error establishing a database connection

Autrement dit, WordPress fonctionne peut-être toujours. Cependant, il n’arrive plus à joindre le serveur de base de données.

Plusieurs situations peuvent provoquer cette erreur.

WordPress utilise plusieurs paramètres pour se connecter à MySQL ou MariaDB.

Ils se trouvent généralement dans le fichier wp-config.php.

Une modification du mot de passe peut donc suffire à bloquer la connexion.

L’utilisateur MySQL doit disposer des droits nécessaires sur la base utilisée par WordPress.

Si ces droits ont été modifiés, la connexion peut échouer.

Le problème peut également venir du serveur.

Par exemple, le service peut être arrêté. Le serveur peut aussi manquer de ressources ou atteindre sa limite de connexions.

Une base endommagée peut également empêcher certaines opérations.

Dans ce cas, une réparation peut parfois résoudre le problème.

Avant toute modification, pensez à vérifier si vous disposez d’une sauvegarde récente.

Cette précaution est importante. Elle permet de revenir en arrière si une manipulation provoque un nouveau problème.

Commencez par vérifier si la base est réellement accessible.

Avec WP-CLI, vous pouvez utiliser :

wp db query

Si vous utilisez directement MySQL, essayez :

mysql -u utilisateur -p -h localhost nom_base

Remplacez les valeurs par celles de votre environnement.

Si la connexion fonctionne, le problème peut venir de la configuration WordPress.

En revanche, si elle échoue également, vérifiez les identifiants ou l’état du serveur.

Le fichier wp-config.php contient les informations utilisées par WordPress pour accéder à la base.

Vérifiez notamment ces paramètres :

define( 'DB_NAME', 'nom_base' );
define( 'DB_USER', 'utilisateur' );
define( 'DB_PASSWORD', 'mot_de_passe' );
define( 'DB_HOST', 'localhost' );

Les valeurs doivent correspondre à votre configuration d’hébergement.

localhost est fréquent. Toutefois, certains hébergeurs utilisent une adresse différente.

Le panneau d’administration de votre hébergement peut fournir cette information.

Si le mot de passe MySQL a été modifié récemment, WordPress peut continuer à utiliser l’ancien.

Dans ce cas, mettez à jour DB_PASSWORD avec la bonne valeur.

Les identifiants peuvent être corrects. Pourtant, l’utilisateur peut ne plus avoir accès à la base.

Depuis phpMyAdmin ou votre panneau d’hébergement, vérifiez :

Si nécessaire, réattribuez les droits adaptés.

Évitez toutefois de modifier les privilèges au hasard. Une mauvaise configuration peut créer un problème de sécurité.

Si les identifiants semblent corrects, le serveur de base de données peut être en cause.

Sur un serveur Linux utilisant systemd, vous pouvez vérifier l’état du service :

sudo systemctl status mysql

Selon votre distribution, le service peut utiliser MariaDB :

sudo systemctl status mariadb

Si le service est arrêté, vous pouvez consulter les journaux avant de le redémarrer.

Par exemple :

sudo journalctl -u mysql --since "30 minutes ago"

Le nom du service peut varier selon votre installation.

Oui.

Un serveur très sollicité peut atteindre sa limite de connexions à la base de données.

Dans ce cas, plusieurs visiteurs peuvent rencontrer la même erreur.

Le problème peut alors être lié à :

Ainsi, augmenter les ressources sans identifier la cause n’est pas toujours la meilleure solution.

Si la base est accessible mais présente des problèmes, WordPress propose une fonction de réparation.

Commencez par sauvegarder votre base.

Ensuite, ouvrez wp-config.php et ajoutez temporairement :

define( 'WP_ALLOW_REPAIR', true );

Vous pourrez ensuite accéder à :

/wp-admin/maint/repair.php

WordPress propose alors plusieurs options de réparation.

Vous pouvez notamment utiliser :

Une fois l’opération terminée, supprimez la ligne WP_ALLOW_REPAIR du fichier wp-config.php.

Cette étape est importante pour éviter de laisser la fonction de réparation accessible.

Une extension peut parfois provoquer des erreurs indirectes.

Si vous n’avez plus accès à l’administration WordPress, vous pouvez désactiver les extensions depuis le système de fichiers.

Avec un accès FTP ou SSH, renommez temporairement le dossier :

wp-content/plugins

Par exemple :

wp-content/plugins-disabled

WordPress ne chargera alors plus les extensions présentes dans ce dossier.

Si le site fonctionne à nouveau, une extension peut être responsable du problème.

Vous pourrez ensuite réactiver les extensions progressivement afin d’identifier celle qui pose problème.

Le thème peut également être à l’origine d’un problème.

Si nécessaire, vous pouvez temporairement passer à un thème WordPress par défaut.

Cette méthode permet de vérifier si le problème vient du thème actif.

Cependant, cette étape est surtout utile lorsque la base fonctionne déjà. Une erreur de connexion à la base doit d’abord être traitée côté MySQL ou MariaDB.

Des fichiers WordPress endommagés peuvent également provoquer différents problèmes.

Avant de remplacer quoi que ce soit, réalisez une sauvegarde.

Vous pouvez ensuite remplacer les fichiers principaux de WordPress par une copie propre de la même version.

Ne supprimez pas wp-content et ne remplacez pas votre fichier wp-config.php sans précaution.

Ces éléments contiennent notamment vos extensions, votre thème, vos médias et votre configuration.

Une migration WordPress peut modifier plusieurs paramètres.

Dans ce contexte, vérifiez en priorité :

De plus, vérifiez que la base de données a bien été importée.

Une migration peut sembler terminée alors que l’import SQL a échoué ou reste incomplet.

Réparer le problème est important. Cependant, la prévention l’est tout autant.

Voici plusieurs bonnes pratiques à mettre en place.

Une sauvegarde complète doit idéalement inclure :

Surtout, conservez plusieurs versions des sauvegardes.

Une sauvegarde unique peut être insuffisante si le problème existe depuis plusieurs jours.

Un site peut devenir instable lorsque les ressources disponibles sont insuffisantes.

Surveillez notamment :

Ainsi, vous pourrez détecter certaines anomalies avant une panne complète.

Les mises à jour corrigent des bugs et des failles de sécurité.

Pensez donc à maintenir :

Cependant, testez les mises à jour importantes lorsque votre environnement le permet.

L’hébergement joue également un rôle important.

Un site avec peu de trafic n’a pas les mêmes besoins qu’une boutique WooCommerce ou qu’un média recevant plusieurs milliers de visiteurs.

Il faut donc choisir une infrastructure adaptée aux besoins réels du projet.

Découvrez les solutions d’hébergement Hostinger

Si toutes les vérifications précédentes sont correctes, le problème peut nécessiter une analyse plus approfondie.

Dans ce cas, consultez les journaux du serveur.

Ils peuvent révéler :

Vous pouvez également contacter le support de votre hébergeur.

Celui-ci pourra vérifier l’état du serveur MySQL, les ressources disponibles et les éventuelles erreurs d’infrastructure.

Lorsque le site est inaccessible, il peut être tentant de modifier plusieurs paramètres simultanément.

Pourtant, cette méthode complique souvent le diagnostic.

Procédez plutôt progressivement :

Ainsi, chaque étape permet d’écarter une cause possible.

L’erreur « Error establishing a database connection » peut sembler grave. Pourtant, elle est souvent liée à un problème identifiable.

Les premières vérifications concernent généralement les identifiants présents dans wp-config.php. Ensuite, il faut contrôler les privilèges et l’état du serveur MySQL ou MariaDB.

Si la connexion fonctionne, d’autres pistes peuvent être étudiées. La base, les extensions, le thème ou les fichiers WordPress peuvent notamment nécessiter une vérification.

Enfin, les sauvegardes restent essentielles. Elles permettent de restaurer rapidement le site en cas de problème.

En appliquant une méthode progressive, vous pourrez donc diagnostiquer cette erreur plus sereinement et remettre votre site WordPress en ligne.

Créer un Site Web en 10 Minutes : Guide Simple et Efficace

Pour renforcer votre stratégie de sauvegarde, vous pouvez également utiliser une solution dédiée comme UpdraftPlus.

UpdraftPlus – Plugin de sauvegarde WordPress

Support WordPress – Error establishing a database connection