Panne

Erreur d'établissement d'une connexion à la base de données : causes et solutions

Mis à jour le 16 octobre 2026 · 8 minutes de lecture

Une page blanche, une seule phrase glaçante : « Erreur d'établissement d'une connexion à la base de données ». Sur un site WordPress, c'est l'un des messages les plus redoutés — et pourtant l'un des plus simples à résoudre une fois qu'on en comprend la cause.

Que signifie réellement ce message

WordPress ne stocke pas vos articles, vos pages ou vos réglages dans de simples fichiers : tout est rangé dans une base de données MySQL, hébergée sur un serveur séparé (même si, bien souvent, il tourne physiquement à côté de votre site). À chaque affichage de page, WordPress doit interroger cette base.

Ce message apparaît quand WordPress ne parvient pas à joindre ce serveur de base de données, ou qu'il le joint mais que les informations de connexion sont refusées. Résultat : la page reste blanche, sur tout le site, pour tous les visiteurs — y compris vous-même dans l'espace d'administration.

C'est important à comprendre : vos contenus ne sont presque jamais perdus. Seule la communication entre WordPress et la base est rompue.

Les causes les plus fréquentes

• Identifiants de connexion incorrects. Un mot de passe de base de données changé côté hébergeur sans mise à jour du fichier wp-config.php.
• Serveur de base de données hors service. Panne ou redémarrage du service MySQL/MariaDB chez l'hébergeur, en général temporaire.
• Trop de connexions simultanées. Sur un hébergement mutualisé, chaque compte a une limite de connexions à la base ; un pic de trafic ou un plugin mal codé peut la dépasser.
• Base de données corrompue. Une coupure de courant, un arrêt brutal du serveur ou une mise à jour interrompue peut endommager une ou plusieurs tables.
• Fichier wp-config.php modifié ou corrompu. Une édition manuelle malheureuse, un caractère invisible ajouté par un éditeur de texte, ou une restauration partielle de sauvegarde.
• Nom d'hôte de connexion incorrect. Après un changement de serveur ou de plan d'hébergement, l'adresse du serveur de base de données change parfois (ce n'est pas toujours localhost).

Diagnostiquer la cause, étape par étape

1. Vérifier si le problème touche tout l'hébergement

Avant de toucher à quoi que ce soit, regardez si d'autres sites hébergés chez le même prestataire sont également touchés, et consultez la page de statut de votre hébergeur. Si un incident est en cours, inutile de modifier vos fichiers : patientez, le service revient généralement en quelques minutes à quelques heures.

2. Contrôler les identifiants dans wp-config.php

Ouvrez le fichier wp-config.php, à la racine de votre site, via le gestionnaire de fichiers de votre hébergeur ou en FTP. Vérifiez que les quatre constantes suivantes correspondent exactement à celles affichées dans votre panneau d'hébergement, rubrique « Bases de données » :

• DB_NAME — le nom de la base
• DB_USER — l'utilisateur autorisé
• DB_PASSWORD — le mot de passe de cet utilisateur
• DB_HOST — l'adresse du serveur (souvent localhost, parfois une autre adresse)

Une seule virgule, un seul espace ou une seule apostrophe manquante suffit à tout bloquer.

3. Réparer la base de données via l'outil intégré de WordPress

Si les identifiants sont corrects mais que l'erreur persiste, la base est peut-être endommagée. Ajoutez temporairement cette ligne juste avant /* C'est tout, ne touchez pas à ce qui suit ! */ dans wp-config.php :

define('WP_ALLOW_REPAIR', true);

Rendez-vous ensuite sur https://votre-site.fr/wp-admin/maint/repair.php et lancez « Réparer et optimiser la base de données ». Une fois terminé, retirez impérativement cette ligne : laissée en place, elle rend l'outil accessible à n'importe quel visiteur.

4. Vérifier la limite de connexions chez votre hébergeur

Dans le panneau d'administration de votre hébergement, l'onglet « Ressources » ou « Utilisation » affiche souvent le nombre de connexions simultanées à la base de données et s'il a été dépassé récemment. Si c'est le cas après un pic de trafic, la solution est soit un plan d'hébergement supérieur, soit un cache plus agressif pour réduire les requêtes vers la base.

Les solutions selon la cause identifiée

Éviter que cela se reproduise

Comme pour la plupart des pannes, le vrai danger n'est pas l'incident lui-même mais le temps qu'il faut pour le découvrir. Une page blanche pendant 20 minutes passe inaperçue ; pendant 3 jours, elle coûte des ventes et des clients.

• Mettez en place des sauvegardes régulières de votre base de données, pour restaurer rapidement en cas de corruption grave.
• Gardez WordPress, votre thème et vos extensions à jour : lisez notre guide sur les risques d'un site WordPress non mis à jour.
• Activez une surveillance externe qui vous alerte dès que votre site cesse de répondre, plutôt que d'attendre l'appel d'un client.

Questions fréquentes