Erreur lors de la connexion à la base de données sur WordPress

Votre site affiche une page blanche avec la phrase « Erreur lors de la connexion à la base de données » (en anglais : « Error establishing a database connection ») ? Vos contenus ne sont pas perdus. Ils sont toujours dans la base, mais WordPress n'arrive plus à s'y connecter. Ce guide vous aide à trouver la cause et à la corriger, même sans connaissances techniques poussées.

Pourquoi cette erreur apparaît-elle ?

WordPress range ses textes, ses pages et ses réglages dans une base de données MySQL. À chaque visite, il s'y connecte grâce aux informations écrites dans le fichier wp-config.php. Si l'une d'elles ne correspond plus, la connexion échoue et le site ne peut rien afficher.

Les causes les plus courantes sont :

• des identifiants incorrects dans wp-config.php, souvent après une migration ou une modification à la main ;
• une base supprimée ou renommée ;
• un mot de passe d'utilisateur changé sans mise à jour de wp-config.php ;
• des tables endommagées après une coupure pendant une mise à jour ;
• un serveur de base de données momentanément surchargé, plus rare.

Avant de commencer

• Vérifiez si l'erreur concerne tout le site ou seulement l'administration (/wp-admin). Si seule l'administration est touchée, les tables sont peut-être endommagées (voir plus bas).
• Si vous venez de modifier un fichier, d'installer une extension ou de migrer le site, notez-le : c'est souvent la piste.
• Une sauvegarde de votre hébergement existe peut-être déjà, voir Restaurer une sauvegarde de votre site.

Corriger l'erreur étape par étape

1. Ouvrez votre hébergement, puis Bases de données, et repérez la base de votre site ainsi que son utilisateur.
2. Ouvrez l'outil Fichiers et allez dans le dossier httpdocs.
3. Ouvrez le fichier wp-config.php pour le modifier.
4. Comparez la valeur de DB_NAME avec le nom exact de la base.
5. Comparez la valeur de DB_USER avec le nom exact de l'utilisateur.
6. Vérifiez la valeur de DB_PASSWORD : c'est le mot de passe de l'utilisateur de la base, pas celui de WordPress.
7. Gardez la valeur de DB_HOST d'origine, sauf indication contraire du support.
8. Enregistrez le fichier, puis rechargez votre site.

Les lignes à vérifier ressemblent à ceci :

• define( 'DB_NAME', 'nom_de_la_base' );
• define( 'DB_USER', 'nom_utilisateur' );
• define( 'DB_PASSWORD', 'mot_de_passe' );
• define( 'DB_HOST', 'hote' );

Attention aux détails : une majuscule, un espace avant ou après la valeur, ou une apostrophe supprimée suffisent à casser la connexion. Gardez bien les apostrophes droites autour de chaque valeur.

Comment vérifier que le mot de passe est le bon ?

Ouvrez la base dans phpMyAdmin depuis l'outil Bases de données, voir Créer une base de données MySQL. Si vous voyez les tables de WordPress (elles commencent souvent par wp_), la base existe et contient bien votre site. Si vous ne connaissez plus le mot de passe de l'utilisateur, ouvrez un ticket au support : il vous aide à le redéfinir, puis vous le reportez dans wp-config.php.

Que faire si l'administration affiche « Une ou plusieurs tables de base de données ne sont pas disponibles » ?

Les tables sont endommagées. WordPress dispose d'un outil de réparation intégré :

1. Ajoutez la ligne define( 'WP_ALLOW_REPAIR', true ); dans wp-config.php, juste au-dessus de la ligne « C'est tout, ne touchez pas à ce qui suit ».
2. Ouvrez l'adresse votredomaine.fr/wp-admin/maint/repair.php.
3. Cliquez sur Réparer la base de données.
4. Une fois la réparation finie, supprimez la ligne ajoutée : sinon, n'importe qui pourrait lancer cet outil.

Et si rien ne fonctionne ?

• Consultez les journaux d'erreurs de l'hébergement (Logs, puis Logs d'erreurs) : ils indiquent souvent le message exact renvoyé par MySQL, comme « Access denied ».
• Restaurez une sauvegarde faite avant l'apparition de l'erreur, voir Restaurer une sauvegarde de votre site.
• Ouvrez un ticket depuis /submitticket.php ou écrivez à support@upkyo.com, en précisant ce que vous avez modifié récemment. Le support répond 24 h/24, 7 j/7.

Comment éviter que l'erreur revienne ?

• Notez les informations de la base dans un gestionnaire de mots de passe dès la création.
• Ne supprimez jamais une base sans vérifier quel site l'utilise.
• Faites vos mises à jour sur un site sauvegardé, voir Mettre à jour WordPress, les extensions et les thèmes.
• Lors d'une migration, mettez à jour wp-config.php avec les informations du nouvel hébergement.

Questions fréquentes

Est-ce que j'ai perdu le contenu de mon site ?

Presque jamais. L'erreur signifie que WordPress ne joint plus la base, pas que la base est vide. Une fois les informations de connexion corrigées, le site revient tel qu'il était.

Où se trouve le fichier wp-config.php ?

À la racine de votre installation WordPress, en général directement dans le dossier httpdocs. Vous pouvez l'ouvrir avec l'outil Fichiers de l'espace client ou en SFTP, voir Se connecter en FTP ou SFTP.

Le mot de passe de la base est-il celui de mon compte WordPress ?

Non. DB_PASSWORD est le mot de passe de l'utilisateur MySQL de la base. Le mot de passe de votre compte administrateur WordPress est différent et ne joue aucun rôle ici.

Pourquoi l'erreur est-elle apparue après une migration ?

Le nouvel hébergement utilise une base, un utilisateur ou un mot de passe différents de l'ancien. Le fichier wp-config.php copié contient encore les anciennes valeurs : remplacez-les par les nouvelles.

L'erreur apparaît par moments puis disparaît, est-ce normal ?

Une erreur intermittente peut venir d'un pic de visites ou d'une extension qui ouvre trop de connexions. Notez l'heure à laquelle elle se produit et ouvrez un ticket : le support pourra consulter les journaux du serveur.