Erreur de connexion à la base de données WordPress : solutions

Une erreur de connexion à la base de données WordPress signifie que le site ne parvient pas à accéder aux données dont il a besoin. Vérifiez d’abord les identifiants dans wp-config.php et l’état du serveur de base de données auprès de votre hébergeur. Si ces éléments sont corrects, examinez les droits de l’utilisateur et l’état des tables.

Vérifier les identifiants dans wp-config.php

WordPress utilise une base de données pour stocker notamment les contenus et les réglages du site. Les informations nécessaires à sa connexion se trouvent dans le fichier wp-config.php, à la racine de l’installation WordPress.

Avant toute modification, faites une sauvegarde des fichiers et de la base de données si vous y avez accès. Conservez aussi une copie du fichier wp-config.php afin de pouvoir revenir à sa configuration précédente.

1. Accédez aux fichiers du site par FTP ou par le gestionnaire de fichiers de votre hébergeur.
2. Ouvrez wp-config.php et repérez les constantes DB_NAME, DB_USER, DB_PASSWORD et DB_HOST.
3. Comparez leurs valeurs avec les informations fournies dans l’espace d’hébergement.
4. Corrigez uniquement les valeurs erronées, en conservant la syntaxe du fichier, puis enregistrez-le.
5. Rechargez le site pour vérifier si l’erreur a disparu.

Le nom d’hôte n’est pas nécessairement localhost : utilisez celui indiqué par votre hébergeur. Si les accès ont été remplacés lors d’une migration ou d’un changement d’hébergement, les anciennes valeurs peuvent ne plus fonctionner.

Vous pouvez également vérifier le préfixe des tables, indiqué par la variable $table_prefix dans wp-config.php. Il doit correspondre au préfixe des tables de l’installation dans la base de données. Un préfixe incorrect peut empêcher WordPress de retrouver ses tables, même si la connexion au serveur fonctionne.

Pour compléter ces contrôles, consultez aussi notre guide sur les erreurs d’accès à la base de données WordPress.

Contrôler les droits et la disponibilité du serveur

Si les identifiants semblent corrects, vérifiez que la base de données est bien activée chez votre hébergeur et que le serveur qui l’héberge est en ligne. Une panne du serveur peut rendre le site inaccessible sans qu’aucune modification de wp-config.php soit nécessaire.

Consultez l’espace client de l’hébergeur ou demandez-lui si un incident affecte le service de base de données. Si le serveur est indisponible, attendez son rétablissement avant de modifier votre configuration.

Vérifiez aussi que l’utilisateur indiqué par DB_USER est associé à la bonne base et dispose des droits nécessaires. Des droits insuffisants peuvent provoquer des erreurs lors de certaines opérations. L’hébergeur peut vous aider à les contrôler ou à les modifier.

Un test avec Telnet peut, lorsque l’hébergement et le réseau l’autorisent, aider à vérifier si le port du serveur est joignable. Ce test ne confirme toutefois ni la validité du mot de passe ni les droits de l’utilisateur ; il n’est pas indispensable pour la plupart des diagnostics.

Réinitialiser le mot de passe de la base de données

Si le mot de passe de la base est perdu ou ne correspond plus à celui enregistré dans WordPress, réinitialisez-le depuis l’espace d’hébergement ou demandez à votre hébergeur de le faire.

Procédez ensuite dans cet ordre :

1. Notez le nouveau mot de passe dans un endroit sûr.
2. Ouvrez wp-config.php et remplacez la valeur de DB_PASSWORD par ce nouveau mot de passe.
3. Enregistrez le fichier, puis rechargez le site.

Changer le mot de passe auprès de l’hébergeur sans le reporter dans wp-config.php empêchera WordPress de se connecter. À l’inverse, modifier seulement le fichier ne change pas le mot de passe enregistré sur le serveur.

Il n’est généralement pas utile de supprimer puis de ressaisir tous les paramètres de connexion : comparez-les d’abord et corrigez seulement ceux qui sont incorrects. Évitez de communiquer ces informations dans un message public.

Vérifier et réparer les tables de la base

Une base peut être accessible alors que certaines de ses tables sont endommagées. Si WordPress signale un problème de tables, ou si l’hébergeur confirme une corruption, sauvegardez la base avant de tenter une réparation.

WordPress dispose d’un outil de réparation. Pour l’activer temporairement, ajoutez cette ligne dans wp-config.php, avant la ligne de commentaire indiquant la fin des modifications :

define( 'WP_ALLOW_REPAIR', true );

Accédez ensuite à l’adresse de votre site suivie de /wp-admin/maint/repair.php et lancez la réparation proposée. Retirez la ligne ajoutée dès que l’opération est terminée : la page de réparation peut être accessible sans connexion à l’administration.

Vous pouvez aussi examiner les tables depuis phpMyAdmin, si votre hébergeur le met à disposition. Sélectionnez la bonne base, repérez les tables concernées et consultez les options de vérification ou de réparation disponibles. Leur disponibilité dépend notamment du type de table ; en cas de doute, demandez conseil à l’hébergeur avant d’agir.

Ne modifiez pas directement les fichiers de stockage du serveur de base de données. Si la réparation échoue, une restauration depuis une sauvegarde saine peut être envisagée après vérification de son contenu et de sa date.

Examiner les fichiers, extensions et mises à jour

Un fichier WordPress endommagé peut contribuer à une panne. Si le problème persiste après les contrôles de connexion, vérifiez les fichiers du site et remplacez les fichiers du cœur corrompus par des copies saines correspondant à votre installation. Ne remplacez pas wp-config.php ni vos contenus sans avoir identifié ce que vous faites et conservé une sauvegarde.

Une extension ou un thème peut aussi provoquer une erreur liée à la base. Pour isoler le problème, désactivez temporairement les extensions, puis réactivez-les une par une en testant le site après chaque activation. Si l’administration est inaccessible, vous pouvez renommer temporairement le dossier wp-content/plugins par FTP, puis le rétablir. Cette manipulation désactive les extensions.

Si nécessaire, testez également un thème WordPress par défaut. Effectuez ces vérifications avec prudence : changer de thème ou désactiver une extension peut modifier temporairement l’apparence ou certaines fonctions du site.

Une fois l’accès rétabli, vérifiez les mises à jour dans Tableau de bord > Mises à jour, ainsi que celles des thèmes et des extensions. Les mises à jour ne corrigent pas systématiquement une erreur de connexion, mais elles permettent de maintenir les composants du site. En cas de difficulté, consultez les solutions aux erreurs de mise à jour de thème.

Écarter les autres causes d’affichage

Le cache du navigateur ne provoque pas une panne du serveur de base de données, mais il peut conserver l’affichage d’une ancienne page d’erreur. Après une correction, rechargez la page, videz le cache du navigateur ou testez dans une fenêtre privée.

Le fichier .htaccess n’est pas non plus la première cause à rechercher pour une erreur de connexion à la base. Si d’autres erreurs d’accès ou de redirection apparaissent, examinez sa configuration après en avoir sauvegardé une copie. Notre guide sur les erreurs liées au fichier .htaccess détaille ces vérifications.

Si le serveur reste indisponible ou si le problème revient, transmettez à votre hébergeur le message affiché et les vérifications déjà effectuées, sans exposer vos mots de passe. Une migration vers un autre hébergement peut être envisagée si le service actuel ne répond pas à vos besoins, mais elle ne remplace pas le diagnostic de la panne.

Lorsque vous ne souhaitez pas intervenir sur les fichiers ou la base, un dépannage de site WordPress permet de confier ces vérifications à une équipe spécialisée.

Questions fréquentes

Article rédigé avec l’aide d’une IA à partir des sources citées et de notre pratique de la maintenance WordPress. Notre méthode éditoriale.