Erreur de connexion à la base de données WordPress : ce que ça veut dire

Ce que dit le message

À chaque page affichée, WordPress ouvre une connexion à sa base de données MySQL ou MariaDB avec quatre informations écrites dans wp-config.php, à la racine du site :

define( 'DB_NAME', 'nom_de_la_base' );
define( 'DB_USER', 'utilisateur' );
define( 'DB_PASSWORD', 'mot_de_passe' );
define( 'DB_HOST', 'localhost' );

« Erreur lors de la connexion à la base de données » veut dire que cette connexion a échoué. Quatre causes le produisent : des identifiants qui ne correspondent plus, un serveur de base de données arrêté ou injoignable, un serveur saturé, ou une base endommagée. Les sections qui suivent les passent de la plus simple à vérifier à la plus rare.

1. Le serveur de base de données répond-il ?

• La page d'état de l'hébergeur : une panne ou une maintenance du serveur MySQL y est annoncée.
• Les autres sites du même compte : s'ils affichent la même erreur au même moment, la cause est du côté du serveur, et le correctif chez l'hébergeur.
• phpMyAdmin, depuis le panneau de l'hébergeur : s'il ouvre la base et affiche ses tables, le serveur fonctionne et la base existe.

Si le serveur est en cause, ouvrez un ticket chez l'hébergeur en donnant l'heure du début de la panne et le message exact. Rien n'est à modifier sur le site pendant ce temps.

2. Les identifiants de wp-config.php sont-ils les bons ?

C'est la cause la plus fréquente après un déménagement de site, un changement de mot de passe de la base dans le panneau de l'hébergeur, ou une restauration. Comparez les quatre valeurs de wp-config.php avec la rubrique des bases de données de votre hébergeur :

• DB_NAME et DB_USER : beaucoup d'hébergeurs les préfixent par le nom du compte (compte_wordpress). Le préfixe fait partie du nom.
• DB_PASSWORD : en cas de doute, définissez un nouveau mot de passe pour l'utilisateur dans le panneau, et reportez-le dans le fichier.
• DB_HOST : localhost chez beaucoup d'hébergeurs, mais pas chez tous. Certains donnent un nom de serveur ou une adresse, parfois suivie d'un port (:3306). La valeur exacte figure dans le panneau.
• L'utilisateur doit avoir les droits sur la base : dans le panneau, vérifiez que l'utilisateur est bien associé à la base, avec tous les privilèges.

Un mot de passe qui contient une apostrophe (') coupe la chaîne PHP qui l'entoure dans wp-config.php. Faites-la précéder d'une barre oblique inverse (\'), ou choisissez un mot de passe sans apostrophe.

Tester les identifiants en dehors de WordPress

WordPress affiche un message générique. MySQL, lui, dit précisément ce qui ne va pas. Deux façons de l'interroger avec les valeurs de wp-config.php :

En ligne de commande, si vous avez un accès SSH

mysql -h localhost -u utilisateur -p nom_de_la_base

Avec WP-CLI, wp db check lit directement wp-config.php et vérifie les tables avec ces identifiants.

Avec un fichier PHP temporaire

Déposez ce fichier à la racine du site sous un nom difficile à deviner, ouvrez-le dans le navigateur, puis supprimez-le aussitôt : il contient le mot de passe de la base.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$lien = @mysqli_connect('localhost', 'utilisateur', 'mot_de_passe', 'nom_de_la_base');
echo $lien ? 'Connexion réussie' : 'Échec : ' . mysqli_connect_error();

La première ligne compte : depuis PHP 8.1, une connexion qui échoue lève une exception par défaut, et la page resterait blanche au lieu d'afficher le message de MySQL.

3. Une base endommagée : l’outil de réparation

Quand les identifiants sont bons mais que des tables sont endommagées, le site public affiche le même message d'erreur de connexion, et l'administration un message plus précis : « Une ou plusieurs tables de votre base de données sont indisponibles. La base de données a peut-être besoin d’être réparée. ». WordPress fournit un outil pour cela. Ajoutez cette ligne dans wp-config.php :

define( 'WP_ALLOW_REPAIR', true );

Ouvrez ensuite https://www.votre-site.com/wp-admin/maint/repair.php et lancez « Réparer la base de données ». Retirez la ligne dès la réparation terminée : tant qu'elle est présente, cette page est accessible à n'importe qui, sans connexion.

Avant toute réparation, faites un export de la base (wp db export, ou l'onglet Exporter de phpMyAdmin). Si la réparation échoue, l'hébergeur peut restaurer la base depuis ses sauvegardes.

4. Une erreur qui va et vient : la charge

Une erreur qui apparaît à certaines heures puis disparaît d'elle-même signale un serveur saturé plutôt qu'un réglage faux. Les causes les plus courantes :

• Un pic de trafic, souvent des robots : tentatives de connexion répétées sur wp-login.php ou xmlrpc.php, visibles dans les journaux d'accès de l'hébergeur.
• Les limites de l'hébergement mutualisé : nombre de connexions simultanées ou de processus plafonné par compte. Le panneau de l'hébergeur les affiche en général dans sa rubrique de consommation des ressources.
• Une extension lourde : statistiques, journaux ou tâches planifiées qui écrivent en base à chaque visite.

Les correctifs : bloquer les tentatives de connexion abusives, installer un cache de pages, désactiver xmlrpc.php si aucune application ne l'utilise, et demander à l'hébergeur les journaux de la période en erreur.