Erreur WordPress : “Error establishing a database connection”

Sommaire

Pourquoi et Comment réparer ?

Premier contact avec l’erreur

Tu te rends sur ton site WordPress ou dans le dashboard, mais tout ce que tu vois, c’est un écran blanc avec ce grand message :

« Error establishing a database connection »

Aucun contenu, aucune interface : le site est complètement inaccessible. Stressant, mais généralement réparable rapidement.

Message d’erreur « Error establishing a database connection » sur WordPress

Comprendre cette erreur

Cette erreur survient parce que WordPress ne parvient pas à communiquer avec sa base de données MySQL/MariaDB. Le site ne peut donc pas charger le contenu ni s’afficher.

Causes fréquentes :

Identifiants (login/mot de passe) incorrects dans wp-config.php
Privileges utilisateur insuffisants
Base de données corrompue ou serveur inutilisable
Surcharge du pool de connexions ou panne du serveur

Guide étape par étape pour rétablir l’accès

Étape 1 – Tester votre accès à la base depuis WP‑CLI ou MySQL

Via WP‑CLI :

wp db query

Ou connecte-toi via terminal :

mysql -u utilisateur -p -h localhost nom_base

Si la connexion échoue : le problème est d’authentification ou de serveur.

Étape 2 – Vérifier et corriger les identifiants dans `wp-config.php`

DB_NAME, DB_USER, DB_PASSWORD, DB_HOST doivent être exacts.
Vérifie via ton panneau d’hébergement si le mot de passe a été modifié.
Si besoin, recrée l’utilisateur et assigne les droits nécessaires (ALL PRIVILEGES).

Étape 3 – Réparer la base de données via WordPress ou phpMyAdmin

Si tu parviens à te connecter :

Ajoute à wp-config.php :

define('WP_ALLOW_REPAIR', true);

Accède à : /wp-admin/maint/repair.php
Choisis Repair Database ou Repair & Optimize Database.
Supprime la ligne du wp-config.php après réparation.

Étape 4 – Vérifier l’état du serveur MySQL

Connecte-toi à ton hébergement ou via SSH.
Vérifie que le processus MySQL/MariaDB tourne et n’est pas saturé (nombre de connexions maxi dépassé, CPU élevé, etc.).
Si tu as trop de connexions simultanées, contacte le support de ton hébergement.