Erreur connexion base de donnees WordPress : 9 solutions

Résolution technique d'une erreur connexion base de donnees wordpress sur un serveur web.
Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois – Creil – Chambly – Chantilly – Clermont – Abbeville – Albert – Amiens – Beaumont-sur-Oise – Cergy – Château-Thierry – Chauny – Compiègne – Crévecœur-le-Grand – Grandvilliers – L'Isle-Adam – Lacroix-Saint-Ouen – Laon – Montdidier – Nanteuil-le-Haudouin – Nogent-sur-Oise – Noyon – Péronne – Persan – Pontoise – Roissy-en-France – Roye – Saint-Maximin (60) – Saint-Quentin – Soissons – Tergnier – Thourotte – Villers-Cotterêts – Département de l'Aisne (02) – Département de la Somme (80) – Estrées-Saint-Denis – Gouvieux – Lamorlaye – Liancourt – Margny-lès-Compiègne – Méru – Ribécourt-Dreslincourt – Saint-Just-en-Chaussée – Senlis – Beauvais – Breteuil – Montataire – Mouy – Pont-Sainte-Maxence – Villers-Saint-Paul – Crépy-en-Valois
Table des matières

Vous ouvrez votre navigateur ce matin, café chaud à la main, et là, c’est la douche froide. Une page blanche sinistre avec cette phrase laconique : « Error establishing a database connection ». Rien d’autre.

Pas de tableau de bord d’administration, pas de vitrine, zéro page visible. Le néant absolu. Vos visiteurs tombent sur un mur et votre chiffre d’affaires s’évapore à chaque seconde qui passe.

On ne va pas se mentir : c’est l’un des bugs les plus anxiogènes de tout l’écosystème. La bonne nouvelle ? Ce problème se résout presque toujours en quelques minutes quand on sait où chercher sans paniquer.

Dans mon agence web basée dans l’Oise, je dépanne ce carnage régulièrement sur des sites de clients pris de panique. Alors, posez votre tasse, ouvrez votre client FTP ou votre console SSH, et suivez le guide. On va mettre les mains dans le cambouis pour régler ça point par point.

Pourquoi WordPress affiche cette satanée erreur de connexion

WordPress fonctionne sur un schéma très simple. D’un côté, vous avez les fichiers PHP, les thèmes et les médias stockés sur votre serveur web. De l’autre côté, vous avez votre base de données MySQL ou MariaDB qui stocke l’intégralité de vos textes, vos comptes utilisateurs, vos réglages et vos commandes WooCommerce.

Pour afficher la moindre page web, PHP doit obligatoirement interroger cette base. Si la passerelle saute, le CMS se retrouve totalement aveugle. Résultat : rideau de fer immédiat.

Dans la vraie vie, une erreur connexion base de donnees wordpress ne vient que de quatre grandes origines :

  • Les identifiants d’accès sont erronés : le mot de passe, l’utilisateur ou le nom de la base dans la configuration ne correspondent plus du tout à ce qui est configuré sur MySQL.
  • Le serveur SQL est tombé : le processus mysqld a crashé par manque de RAM, souvent causé par un pic de trafic violent ou un voisin de serveur indélicat en mutualisé.
  • Les tables sont corrompues : une coupure brutale pendant une écriture sur le disque ou une mise à jour qui tourne mal a bousillé l’indexation de certaines tables.
  • Le quota disque ou d’inodes est saturé : MySQL tente d’écrire des fichiers temporaires mais votre hébergement bloque net toute nouvelle écriture physique.

Voici un comparatif rapide des symptômes courants pour identifier directement la source du crash avant d’attaquer les réparations :

Symptôme visible à l’écran Origine la plus probable Action prioritaire
Message identique sur le front-end et dans /wp-admin/ Identifiants faux ou serveur MySQL totalement arrêté Vérifier wp-config.php et l’état du démon mysqld
Front-end en erreur, mais wp-admin demande une réparation Tables MySQL corrompues suite à une écriture interrompue Activer l’outil de réparation natif WP_ALLOW_REPAIR
L’erreur survient par intermittence aux heures de pointe Saturation de la mémoire vive (RAM) ou limites de connexions Analyser la charge serveur et les requêtes lentes
Erreur survenue juste après une migration ou un changement de domaine L’hôte DB_HOST ou le préfixe des tables est incorrect Corriger DB_HOST ou réaligner le table_prefix

1. Vérifier les identifiants MySQL dans votre fichier wp-config.php

C’est la cause numéro un. Dans au moins 60 % des dépannages que je traite en urgence, le souci vient d’une faute de frappe, d’une modification récente de mot de passe via l’hébergeur ou d’une mauvaise manipulation lors d’une migration manuelle.

Connectez-vous à la racine de votre site via SFTP ou depuis le gestionnaire de fichiers de votre hébergement. Ouvrez le fichier wp-config.php situé à la racine du site web.

Inspectez minutieusement ces quatre constantes PHP définies vers le haut du fichier :

// Nom de la base de donnees
define( 'DB_NAME', 'nom_de_votre_base' );

// Utilisateur MySQL
define( 'DB_USER', 'utilisateur_bdd' );

// Mot de passe de l'utilisateur MySQL
define( 'DB_PASSWORD', 'VotreMotDePasseUltraSecurise' );

// Adresse de l'hote MySQL
define( 'DB_HOST', 'localhost' );

Ouvrez l’interface de gestion de votre hébergeur (par exemple votre cPanel o2switch ou le tableau de bord OVHcloud) et rendez-vous dans la rubrique « Bases de données MySQL ». Vérifiez scrupuleusement que le nom de la base et le nom de l’utilisateur correspondent caractère par caractère. Attention aux préfixes que les hébergeurs ajoutent souvent automatiquement devant le nom de l’utilisateur !

En cas de doute persistant sur le mot de passe, ne tournez pas en rond pendant deux heures : redéfinissez un nouveau mot de passe directement dans votre interface d’hébergement pour cet utilisateur, puis collez-le immédiatement dans votre fichier wp-config.php.

2. Corriger la valeur de l’hôte de base de données (DB_HOST)

La plupart des tutoriels vous diront que DB_HOST vaut systématiquement localhost. C’est faux.

Sur un serveur dédié ou sur la grande majorité des hébergements mutualisés classiques, localhost ou 127.0.0.1 fonctionne parfaitement. Mais chez certains hébergeurs historiques ou sur des architectures cloud avec des serveurs de bases de données déportés, cette valeur est totalement différente.

Chez OVHcloud par exemple, l’hôte ressemble très souvent à une adresse réseau dédiée du type mondomaine.mysql.db ou mysql51-XX.perso. Si vous laissez localhost, le script PHP cherche un socket Unix local qui n’existe tout simplement pas.

Un détail technique qui trompe beaucoup de développeurs : sur certaines versions récentes de PHP et de Linux, remplacer ‘localhost’ par ‘127.0.0.1’ force une connexion via TCP/IP au lieu d’un socket Unix, ce qui résout instantanément des blocages de permissions réseau inexpliqués.

Si vous utilisez un port non standard (par exemple si votre instance MySQL écoute sur le port 3307 au lieu du classique 3306), vous devez préciser ce port directement dans la constante sous cette syntaxe : define( 'DB_HOST', '127.0.0.1:3307' );.

3. Lancer la réparation automatique des tables corrompues de WordPress

Il arrive parfois un cas de figure très révélateur : vous visitez l’accueil du site et vous lisez « Erreur lors de la connexion à la base de données », mais en essayant d’accéder à /wp-admin/, WordPress affiche un message différent indiquant : « Une ou plusieurs tables de la base de données sont indisponibles. La base de données doit peut-être être réparée. »

Cela signifie que la connexion réseau fonctionne, mais que des tables spécifiques (souvent wp_posts ou wp_options) ont subi une corruption interne de leurs index. C’est classique après un arrêt soudain du serveur en pleine écriture.

WordPress intègre nativement un script de réparation d’urgence, mais il est désactivé par défaut pour des raisons évidentes de sécurité. Pour le déclencher, éditez votre fichier wp-config.php et ajoutez cette ligne juste avant la phrase « /* C’est tout, ne touchez pas à ce qui suit ! */ » :

define( 'WP_ALLOW_REPAIR', true );

Enregistrez le fichier, puis ouvrez votre navigateur à l’adresse suivante : https://votresite.com/wp-admin/maint/repair.php. Vous aurez alors deux boutons : « Réparer la base de données » ou « Réparer et optimiser la base de données ». Choisissez la première option pour aller vite.

Une fois le script terminé et le site revenu en ligne, supprimez immédiatement cette ligne de votre wp-config.php. Si vous la laissez traîner, n’importe quel internaute ou robot malveillant pourra relancer ce script lourd en boucle et faire tomber votre serveur.

4. Isoler le problème avec un script PHP de test indépendant

Quand WordPress refuse de se connecter, le réflexe de base consiste à savoir si le problème vient du CMS lui-même ou de l’infrastructure globale du serveur. Si vous ne testez pas la couche PHP/MySQL de façon isolée, vous naviguez à l’aveugle.

Pour en avoir le cœur net en trente secondes chrono, créez un fichier temporaire nommé test-db.php à la racine de votre hébergement avec le code suivant :

<?php
$link = mysqli_connect('localhost', 'votre_utilisateur', 'votre_mot_de_passe');
if (!$link) {
    die('Erreur de connexion MySQL brute : ' . mysqli_connect_error());
}
echo 'Connexion au serveur MySQL réussie avec succès !';
mysqli_close($link);
?>

N’oubliez pas d’adapter les trois paramètres avec les identifiants exacts que vous avez inscrits dans votre wp-config.php. Appelez ensuite ce script dans votre navigateur : https://votresite.com/test-db.php.

Deux résultats possibles :

  • Si le script affiche l’erreur brute : WordPress n’y est pour rien ! Le problème se situe à 100 % au niveau des identifiants, des privilèges de votre utilisateur MySQL ou de l’état du serveur d’hébergement.
  • Si la connexion réussit : le serveur SQL répond parfaitement. Le souci provient alors d’une extension vérolée, d’un préfixe de table erroné dans WordPress, ou d’une corruption logicielle interne du CMS.

Dès que le test est effectué, effacez immédiatement ce fichier du serveur. Ne laissez jamais traîner un script exposant des identifiants en clair.

Coupure matérielle de communication provoquant une panne serveur et base de données.

5. Redémarrer le démon MySQL et vérifier la mémoire vive (RAM)

Si vous possédez votre propre serveur VPS ou dédié, le coupable habituel s’appelle l’OOM Killer (Out Of Memory Killer). Quand la mémoire vive du serveur arrive à saturation complète, le noyau Linux prend une décision expéditive pour sauver la machine : il tue le processus le plus gourmand. Et ce processus, neuf fois sur dix, c’est MySQL.

Connectez-vous en SSH à votre serveur et vérifiez immédiatement si le service tourne encore :

sudo systemctl status mysql
# Ou sur MariaDB selon votre distribution :
sudo systemctl status mariadb

Si le statut est marqué comme « inactive (dead) » ou « failed », vous tenez votre coupable. Tentez un redémarrage propre :

sudo systemctl restart mysql

Jetez ensuite un œil aux journaux système avec la commande dmesg -T | grep -i oom ou fouillez le fichier /var/log/mysql/error.log. Si vous constatez que le démon a été exécuté pour manque de RAM, redémarrer le service ne sera qu’un pansement sur une jambe de bois. Le site retombera au prochain pic de visites.

Il vous faudra soit redimensionner votre serveur vers une offre supérieure, soit configurer un fichier de swap temporaire, soit tailler dans les requêtes désastreuses de certains plugins mal codés qui saturent le buffer mémoire.

6. Contrôler les privilèges et droits de l’utilisateur MySQL

Avoir les bons identifiants ne suffit pas toujours. L’utilisateur doit aussi avoir l’autorisation formelle d’accéder à la base en question et de manipuler ses données.

Lors d’un audit récent pour une refonte de création site Compiègne, j’ai vu un cas d’école : le client avait bien créé sa base et son utilisateur sur son panel d’hébergement, mais il avait tout simplement oublié d’associer l’utilisateur à la base avec les privilèges complets ! L’utilisateur existait, le mot de passe était bon, mais il n’avait pas le droit d’ouvrir la porte.

Rendez-vous dans phpMyAdmin ou dans votre interface de gestion de base de données. Si vous avez la main en ligne de commande avec le compte root, accordez l’intégralité des privilèges nécessaires au bon fonctionnement de WordPress en exécutant ces requêtes :

GRANT ALL PRIVILEGES ON nom_de_votre_base.* TO 'utilisateur_bdd'@'localhost';
FLUSH PRIVILEGES;

Si vous êtes sur un hébergement mutualisé, vérifiez dans l’écran de gestion MySQL que votre utilisateur est bien coché avec tous les droits : SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, et ALTER. Sans ces permissions élémentaires, WordPress s’arrête net dès qu’il tente de mettre à jour un transient ou une option en session.

Pour ceux qui veulent approfondir les normes officielles de configuration de l’infrastructure, la documentation officielle de wp-config.php sur WordPress.org détaille l’intégralité des constantes acceptées par le noyau.

7. Contrôler le quota d’espace disque et les limites d’inodes

Voilà un piège vicieux que beaucoup de débutants ignorent royalement. Vous vérifiez vos identifiants : ils sont parfaits. Votre serveur MySQL tourne : impeccable. Pourtant, l’erreur de connexion persiste obstinément.

Pourquoi ? Parce que votre partition disque est pleine à 100 %. MySQL a impérativement besoin d’espace disque libre pour créer des tables temporaires, gérer ses fichiers de verrouillage et écrire ses journaux de transactions (logs InnoDB). Si l’espace est saturé à ras bord, le moteur bloque toute nouvelle tentative de connexion.

Le piège est encore plus pervers avec les inodes. Même s’il vous reste 20 Go d’espace disque libre en apparence, si votre hébergement bloque le nombre total de fichiers (souvent fixé entre 250 000 et 500 000 fichiers sur les formules grand public) et que votre dossier de cache a généré des millions de petits fichiers, le système d’exploitation refuse toute nouvelle allocation de bloc.

Tapez ces deux commandes en console pour checker la situation en dix secondes :

# Verifier l'espace disque en Go
df -h

# Verifier la consommation des inodes en pourcentage
df -i

Si une ligne affiche une utilisation à 100 %, faites le ménage immédiatement. Videz les caches périmés, purgez les vieux fichiers de sauvegarde locaux oubliés qui dorment dans wp-content/uploads/, ou nettoyez les répertoires de logs encombrés.

8. Vérifier les URL du site dans la base et le fichier .htaccess

Une mauvaise manipulation d’URL peut également conduire indirectement à des boucles de redirection qui finissent par épuiser les processus MySQL et renvoyer une erreur de connexion.

Si vous avez bricolé vos certificats SSL ou forcé des redirections sauvages dans votre fichier .htaccess, vérifiez que les valeurs enregistrées pour votre domaine sont parfaitement cohérentes. Pour valider l’intégrité de vos directives de réécriture, vous pouvez consulter la documentation sur le serveur web Apache HTTP Server.

Vous pouvez forcer manuellement les deux URLs fondamentales de WordPress directement dans votre fichier wp-config.php sans même avoir besoin d’ouvrir phpMyAdmin. Cela neutralise temporairement les valeurs stockées dans la table wp_options :

define( 'WP_HOME', 'https://votresite.com' );
define( 'WP_SITEURL', 'https://votresite.com' );

Cette manipulation simple débloque fréquemment des situations critiques après un changement de protocole HTTP vers HTTPS mal orchestré ou un transfert de nom de domaine.

9. Désactiver les extensions coupables après une mise à jour ratée

Certains plugins d’analyse, d’optimisation agressive de base de données ou de pare-feu interviennent très tôt dans le cycle d’amorçage de WordPress via des fichiers spéciaux comme advanced-cache.php ou db.php placés dans le dossier wp-content/.

Si une mise à jour automatique de plugin plante en plein milieu de nuit ou si deux extensions de cache se marchent sur les pieds, ces scripts de substitution peuvent casser la communication standard avec MySQL. Si vous cherchez à securiser site wordpress convenablement, veillez toujours à tester ces outils de sécurité sur un environnement de staging avant de les balancer en production.

Pour neutraliser ce problème sans avoir accès à l’administration de WordPress :

  • Accédez au dossier wp-content/ par SFTP.
  • Renommez le sous-dossier plugins en plugins_desactive. Cela coupe instantanément toutes les extensions sans supprimer la moindre donnée.
  • Vérifiez si des fichiers nommés db.php ou object-cache.php existent dans wp-content/. Si c’est le cas, renommez-les temporairement en db.php.bak.
  • Rechargez votre site web.

Si la page d’accueil réapparaît enfin, vous tenez votre réponse : l’une de vos extensions a corrompu la couche de transport SQL. Il ne vous reste plus qu’à renommer votre dossier en plugins, puis à réactiver vos extensions une par une depuis l’administration pour isoler la coupable et la jeter à la poubelle.

Si vous n’avez ni le temps ni l’envie de risquer l’intégrité de votre boutique en ligne avec des manipulations en ligne de commande, déléguer la maintenance et le dépannage d’urgence à une agence web expérimentée reste souvent l’option la plus rapide pour reprendre sereinement votre activité sans perdre de données critiques.

Foire Aux Questions (FAQ)

Est-ce que je risque de perdre mes articles ou mes produits lors de cette erreur ?

Non, rassurez-vous. L’erreur signifie simplement que WordPress n’arrive plus à lire le contenu de la base de données. Vos textes, vos articles et vos fiches produits sont toujours bien présents sur le disque dur du serveur. Sauf si la panne provient d’un crash matériel total de votre hébergeur sans sauvegarde, vos données sont saines et attendent simplement le rétablissement de la passerelle de connexion.

Combien de temps faut-il pour résoudre ce problème ?

Si l’erreur vient d’une faute de frappe dans le mot de passe de wp-config.php ou d’un plugin corrompu, cela prend entre cinq et dix minutes. Si le problème vient d’une corruption sévère de tables InnoDB volumineuses ou d’un serveur MySQL qui crashe en boucle par saturation matérielle, l’intervention peut demander une à deux heures d’analyse technique poussée.

Pourquoi cette panne arrive-t-elle soudainement sans que personne n’ait touché au site ?

C’est l’incompréhension classique des propriétaires de sites. Même si vous n’avez pas touché au code, votre hébergeur a pu migrer silencieusement votre base vers un autre cluster MySQL, votre quota d’espace disque a pu être dépassé à cause de logs volumineux, ou un robot d’indexation agressif a provoqué un pic de trafic qui a vidé la mémoire vive du serveur, poussant Linux à couper net le service SQL.

Mon hébergeur me dit que tout va bien de son côté, que faire ?

C’est la réponse standard des supports de niveau 1 qui se contentent de vérifier si la machine répond au ping. Utilisez le script indépendant test-db.php présenté dans l’article. Si ce script minimaliste échoue également à se connecter, vous avez la preuve irréfutable que le souci vient de la configuration de l’infrastructure d’hébergement et non de vos fichiers WordPress.

Sebastien-Larrivee-v2.png

Sébastien Larrivée

Développeur - Rédacteur de contenu

iZyLiFy Conception Web, agence web oise

Je suis Sébastien Larrivée, développeur web sénior chez Nord-Image à Abbeville le jour, et freelance acharné la nuit. Concepteur d’applications, grand malade de SEO, accroc aux cryptos et collectionneur compulsif d’intelligences artificielles… Mais avant tout, je suis expert WordPress depuis plus de 10 ans. Ici, pas de blabla : je partage ce que je teste sur mes serveurs, j’aime quand le code est propre, quand c’est optimisé et surtout, quand ça ranke sur Google.

WordPress
SEO Technique
Développement Web
PHP
Table des matières
Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Besoin
d'un site internet d'un site e-commerce de référencement naturel d'optimisation technique d'un audit ?

Chat avec Izy
1 Chat
izy ×
Fermer