L’erreur « Erreur de base de données » après une migration WordPress est un problème fréquent qui peut paralyser votre site. Que vous ayez changé d’hébergement, déplacé votre site vers un nouveau domaine ou modifié la structure de votre base de données, cette erreur indique que WordPress ne parvient pas à se connecter à la base de données. Pas de panique : dans cet article, nous allons explorer les causes possibles et vous fournir des solutions concrètes pour résoudre rapidement ce souci. Suivez le guide !
Table des matières:
Comprendre l’erreur de base de données après une migration
L’erreur de base de données se manifeste généralement par un message du type : « Erreur de connexion à la base de données » ou « Erreur de base de données ». Cela signifie que le fichier wp-config.php de WordPress contient des informations de connexion incorrectes, ou que la base de données elle-même est inaccessible. Après une migration, plusieurs paramètres peuvent être modifiés : nom d’utilisateur, mot de passe, nom de la base de données, ou encore l’adresse du serveur MySQL (hôte).
Les causes les plus fréquentes
- Informations de connexion erronées : Le nom de la base de données, l’utilisateur ou le mot de passe ont changé lors de la migration.
- Fichier wp-config.php non mis à jour : Les constantes DB_NAME, DB_USER, DB_PASSWORD ou DB_HOST pointent encore vers l’ancien environnement.
- Problèmes de privilèges utilisateur : L’utilisateur de la base de données n’a pas les droits suffisants (SELECT, INSERT, UPDATE, DELETE, etc.).
- Base de données manquante ou corrompue : La base de données n’a pas été correctement importée ou a été endommagée pendant le transfert.
- Adresse de l’hôte MySQL incorrecte : Certains hébergeurs utilisent ‘localhost’, d’autres une adresse IP ou un nom de serveur spécifique.
- Fichiers de cache de requêtes : Si vous utilisez un plugin de cache, des fichiers obsolètes peuvent générer des conflits.
Étapes pour résoudre l’erreur de base de données après migration
Voici une méthodologie pas à pas pour identifier et corriger le problème.
1. Vérifier les identifiants dans wp-config.php
Connectez-vous à votre serveur via FTP ou le gestionnaire de fichiers de votre hébergement. Ouvrez le fichier wp-config.php situé à la racine de votre installation WordPress. Vérifiez les lignes suivantes :
define('DB_NAME', 'nom_de_votre_base');
define('DB_USER', 'utilisateur');
define('DB_PASSWORD', 'mot_de_passe');
define('DB_HOST', 'localhost');
Assurez-vous que ces valeurs correspondent exactement à celles fournies par votre hébergeur. Si vous avez changé d’hébergeur, le nom de la base de données et l’utilisateur sont souvent différents. Contactez votre support si nécessaire.
2. Tester la connexion avec un script PHP
Pour isoler le problème, créez un fichier testdb.php avec le contenu suivant :
Placez ce fichier à la racine de votre site et accédez-y via votre navigateur. Si vous voyez « Connexion réussie », le problème vient d’ailleurs. Sinon, l’erreur affichée vous guidera (mauvais mot de passe, base introuvable, etc.). Pensez à supprimer ce fichier après le test pour des raisons de sécurité.
3. Réinitialiser le mot de passe de la base de données
Si vous avez un doute sur le mot de passe, vous pouvez le réinitialiser via phpMyAdmin ou le panneau de contrôle de votre hébergement. Créez un nouveau mot de passe fort et mettez à jour le fichier wp-config.php en conséquence.
4. Vérifier les privilèges de l’utilisateur
Dans phpMyAdmin, sélectionnez votre base de données, allez dans l’onglet « Privilèges » et assurez-vous que l’utilisateur a tous les droits nécessaires (surtout SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER). Si ce n’est pas le cas, éditez les privilèges et cochez « Tous ».
5. Réimporter la base de données
Si la base de données est corrompue ou incomplète, réimportez-la proprement. Exportez la base de données d’origine via phpMyAdmin (format SQL), puis importez-la dans la nouvelle base. Utilisez de préférence l’outil d’import de phpMyAdmin ou la ligne de commande pour les gros fichiers.
6. Modifier l’hôte MySQL
Certains hébergeurs utilisent une adresse spécifique comme ‘mysql.votresite.com’ au lieu de ‘localhost’. Consultez la documentation de votre hébergeur ou le mail de bienvenue pour connaître la bonne valeur. Mettez à jour DB_HOST dans wp-config.php.
7. Vider le cache du navigateur et du site
Parfois, une ancienne page en cache affiche l’erreur alors que le problème est résolu. Videz le cache de votre navigateur et, si vous avez un plugin de cache, videz-le également. Vous pouvez aussi désactiver temporairement les plugins de cache en renommant le dossier wp-content/cache.
8. Utiliser un plugin de réparation de base de données
Si vous suspectez une corruption, activez la réparation automatique en ajoutant cette ligne dans wp-config.php (avant la ligne « That’s all, stop editing! ») :
define('WP_ALLOW_REPAIR', true);
Ensuite, accédez à votresite.com/wp-admin/maint/repair.php. Vous pouvez choisir « Réparer la base de données » ou « Réparer et optimiser ». Une fois terminé, supprimez cette ligne du fichier.
Prévenir l’erreur de base de données lors des futures migrations
Pour éviter ce genre de désagrément, suivez ces bonnes pratiques :
- Utilisez un plugin de migration : Des outils comme Duplicator, All-in-One WP Migration ou UpdraftPlus gèrent automatiquement la mise à jour des identifiants.
- Vérifiez les informations de connexion avant de modifier les DNS : Assurez-vous que le site fonctionne sur le nouvel hébergement avant de pointer le domaine.
- Effectuez une sauvegarde complète : Base de données et fichiers, avant toute migration.
- Testez dans un environnement de staging : Reproduisez la migration sur un sous-domaine ou un dossier temporaire pour valider le processus.
- Documentez les modifications : Notez les nouveaux identifiants et l’hôte MySQL pour les retrouver facilement.
Conclusion
L’erreur de base de données après une migration est un obstacle courant mais rarement insurmontable. En vérifiant méthodiquement les informations de connexion, les privilèges utilisateur et l’intégrité de la base, vous pourrez rapidement rétablir l’accès à votre site. N’oubliez pas de toujours effectuer des sauvegardes et d’utiliser des outils adaptés pour simplifier les migrations futures. Si le problème persiste, n’hésitez pas à contacter le support de votre hébergeur : ils peuvent vérifier les paramètres serveur. Avec ces solutions, vous êtes désormais prêt à gérer sereinement toute migration WordPress.
Photo by Ilija Boshkov on Unsplash
