Erreur d’accès à la base de données WordPress : que faire ?

Une erreur d’accès à la base de données WordPress peut provenir d’identifiants incorrects, de permissions insuffisantes ou d’un problème sur le serveur. Vérifiez d’abord le fichier wp-config.php et l’état de la base auprès de votre hébergeur, puis examinez PHP, les extensions et les tables si nécessaire. Avant toute modification, faites une sauvegarde des fichiers et de la base si vous y avez accès.

Vérifier les identifiants de la base de données WordPress

WordPress utilise les informations enregistrées dans le fichier wp-config.php pour accéder à sa base de données. Une erreur dans l’une d’elles peut empêcher le site de fonctionner, notamment après une migration ou un changement de mot de passe.

Pour les contrôler :

1. Connectez-vous à votre hébergement par FTP ou ouvrez son gestionnaire de fichiers.
2. À la racine de l’installation WordPress, téléchargez une copie de wp-config.php avant de le modifier.
3. Ouvrez le fichier et repérez les valeurs DB_NAME, DB_USER, DB_PASSWORD et DB_HOST.
4. Comparez-les avec les informations disponibles dans le panneau de votre hébergeur. Demandez-lui le nom d’hôte si vous ne le connaissez pas : il ne s’agit pas toujours de localhost.
5. Corrigez uniquement les valeurs erronées, en conservant les guillemets et la syntaxe du fichier. Enregistrez, puis rechargez le site.

Ne publiez pas le contenu de wp-config.php : il contient des informations sensibles. Pour compléter ces vérifications, consultez aussi notre guide sur les erreurs de connexion à la base de données WordPress.

Contrôler les permissions et le mot de passe

Même avec les bons identifiants, l’utilisateur de la base doit être autorisé à accéder à celle indiquée dans wp-config.php et à effectuer les opérations nécessaires. Les permissions sont gérées selon l’hébergement dans son panneau de configuration ou dans un outil comme phpMyAdmin.

Vérifiez que l’utilisateur associé à DB_USER dispose des droits sur la base indiquée par DB_NAME. Si vous ne voyez pas les permissions ou ne savez pas lesquelles appliquer, demandez à votre hébergeur de les contrôler. Évitez de modifier les droits d’autres utilisateurs sans connaître leur rôle.

Si le mot de passe est inconnu ou compromis, réinitialisez-le depuis le panneau de l’hébergeur ou l’outil de gestion prévu à cet effet. Reportez ensuite le nouveau mot de passe dans DB_PASSWORD et testez le site. Un changement effectué uniquement dans le panneau d’hébergement empêchera WordPress de se connecter tant que le fichier de configuration n’aura pas été mis à jour.

Vous pouvez aussi vérifier si un mot de passe a été exposé avec HaveIBeenPwned. En cas de doute, remplacez-le par un mot de passe unique et mettez à jour la configuration du site.

Examiner la version de PHP et le serveur

Une configuration serveur inadaptée ou un service de base de données indisponible peut également provoquer une erreur. Si les identifiants et les permissions sont corrects, vérifiez auprès de l’hébergeur que le serveur de base de données fonctionne et qu’il est accessible depuis le site.

Si l’administration WordPress reste accessible, ouvrez Outils > Santé du site > Informations, puis consultez la section consacrée au serveur pour connaître la version de PHP utilisée. Vous pouvez aussi trouver cette information dans le panneau d’hébergement.

Une version de PHP incompatible avec WordPress, une extension ou le thème peut entraîner des dysfonctionnements. Avant de la changer, vérifiez la compatibilité de votre site et disposez d’une sauvegarde. Notre guide sur les mises à jour WordPress et PHP présente les éléments à prendre en compte.

Certains réglages PHP peuvent être définis dans un fichier php.ini, mais son emplacement et les paramètres modifiables dépendent de l’hébergement. Ne changez pas ces réglages au hasard : demandez à l’hébergeur de vérifier les journaux et la configuration s’il existe un doute.

Réparer les tables de la base de données

Si la connexion fonctionne mais que certaines tables présentent des erreurs, une réparation peut être envisagée. Faites d’abord une sauvegarde de la base : une intervention sur les tables peut modifier les données, et toutes les erreurs ne relèvent pas d’une corruption.

Plusieurs outils sont possibles selon votre accès :

• phpMyAdmin : sélectionnez la base, puis examinez les tables et les options de vérification ou de réparation proposées. Leur disponibilité dépend du type de table.
• WP-CLI : cet outil en ligne de commande permet notamment de vérifier ou de réparer une base si votre hébergement autorise son utilisation.
• Une extension de réparation, telle que WP Repair : vérifiez sa compatibilité et ses instructions avant de l’utiliser.

Une requête SQL peut également servir à réparer certaines tables depuis phpMyAdmin. Elle doit toutefois être adaptée au type de table et au problème constaté : ne lancez pas de requête trouvée au hasard sur une base de production. Si vous ne pouvez pas établir la cause, demandez à l’hébergeur de vérifier les tables et les messages d’erreur.

Tester les extensions et le thème

Si l’accès à la base semble correct mais que le dysfonctionnement persiste, une extension ou le thème peut être en cause. Effectuez ces tests après une sauvegarde, de préférence sur une copie du site : désactiver des éléments sur le site public peut modifier son apparence ou ses fonctions.

Si vous pouvez accéder à l’administration :

1. Ouvrez Extensions > Extensions installées, puis désactivez temporairement les extensions.
2. Testez le site. Si le problème disparaît, réactivez les extensions une à une en testant après chaque activation.
3. Si le problème persiste, ouvrez Apparence > Thèmes et activez temporairement un thème WordPress par défaut installé sur le site.
4. Testez de nouveau, puis rétablissez la configuration initiale ou examinez l’élément qui semble provoquer l’erreur.

Si l’administration est inaccessible ou si ces vérifications ne permettent pas d’identifier la cause, le dépannage d’un site WordPress en panne peut inclure un examen des fichiers, de la base et du serveur.

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.