« Error establishing a database connection », en français « Erreur d'établissement d'une connexion à la base de données », signifie que WordPress n'arrive pas à joindre sa base de données, où sont stockés tous vos contenus. Le site est alors inaccessible, mais vos données sont presque toujours intactes. Voici comment diagnostiquer et corriger le problème.
Pourquoi cette erreur apparaît
- des identifiants incorrects dans le fichier wp-config.php, par exemple après une migration ou un changement de mot de passe ;
- un serveur de base de données indisponible ou surchargé ;
- une base de données corrompue (table endommagée, arrêt brutal du serveur) ;
- une limite de l'hébergement atteinte (espace disque, nombre de connexions) ;
- un utilisateur de base de données qui n'a plus les droits nécessaires.
Étape 1 : vérifier si seul le site est touché
Ouvrez la page d'administration (adresse du site suivie de /wp-admin). Si elle affiche un message différent, du type tables de base de données indisponibles, la base est probablement endommagée. Si l'administration affiche la même erreur de connexion, le problème vient des identifiants ou du serveur. Voici deux tests rapides :
- connectez-vous au panneau de votre hébergeur et ouvrez phpMyAdmin : si la base s'affiche, elle existe et le serveur fonctionne ;
- consultez la page d'état de votre hébergeur, au cas où une panne serait en cours.
Étape 2 : contrôler les identifiants dans wp-config.php
Ouvrez le fichier wp-config.php à la racine du site et comparez quatre valeurs avec celles du panneau de l'hébergeur :
- DB_NAME : le nom de la base de données.
- DB_USER : l'utilisateur de la base.
- DB_PASSWORD : son mot de passe.
- DB_HOST : le serveur de base de données. C'est souvent localhost, mais certains hébergeurs imposent un nom précis.
Un détail qui piège
Un espace en trop ou un caractère spécial mal recopié suffit à bloquer la connexion. Faites un copier-coller des valeurs plutôt que de les retaper.
Étape 3 : réparer une base de données corrompue
Si le serveur répond mais que la base semble endommagée, WordPress dispose d'un outil de réparation intégré :
- Faites une sauvegarde de la base avant toute manipulation.
- Ajoutez cette ligne dans wp-config.php : define( 'WP_ALLOW_REPAIR', true );
- Ouvrez l'adresse du site suivie de /wp-admin/maint/repair.php et choisissez de réparer la base de données.
- Supprimez ensuite la ligne ajoutée : tant qu'elle est présente, cette page de réparation est accessible à tout le monde, sans connexion.
Étape 4 : contacter l'hébergeur
Si les identifiants sont corrects et que la base n'est pas corrompue, le serveur de base de données est peut-être en panne ou une limite est atteinte. Ouvrez un ticket auprès de votre hébergeur en précisant le message d'erreur. En dernier recours, restaurez une sauvegarde saine, comme expliqué dans notre guide sauvegarde WordPress.
Prévenir cette erreur
Des sauvegardes régulières et une surveillance du site permettent de réagir vite quand la connexion tombe. Voir aussi notre article Erreur 500 sur WordPress et notre guide erreurs WordPress et leurs solutions. Découvrez notre forfait de maintenance ou demandez un audit gratuit.