Une erreur de connexion MySQL signifie généralement que votre site web ne peut pas atteindre la base de données en raison d’identifiants incorrects, d’une limite de connexions atteinte, d’un service de base de données arrêté ou de problèmes réseau. La solution dépend du message d’erreur exact : vérifiez d’abord les droits d’utilisateur et le mot de passe, examinez ensuite le nombre de connexions actives et contrôlez enfin si le serveur de base de données fonctionne réellement.
Messages d’erreur MySQL courants
Avant de pouvoir résoudre le problème, vous devez savoir à quelle erreur vous avez affaire. Les messages les plus courants sont :
- Error establishing a database connection – fréquent avec WordPress, indique des identifiants incorrects ou une base de données qui ne répond pas.
- Too many connections – le nombre maximal de connexions simultanées est atteint.
- Access denied for user – le nom d’utilisateur, le mot de passe ou les droits sont incorrects.
- Can’t connect to MySQL server – le serveur de base de données n’est pas accessible, par exemple en raison d’un nom d’hôte incorrect ou d’un service arrêté.
- Lost connection to MySQL server during query – la connexion se perd pendant une requête lourde ou longue, souvent à cause d’un timeout.
Chaque message indique une cause différente, commencez donc toujours par lire le texte exact dans votre journal d’erreurs ou sur votre site web.
Causes des erreurs de connexion
Les erreurs de connexion résultent généralement d’une combinaison de configuration et de charge. Les causes les plus courantes sont :
- Identifiants incorrects dans le fichier de configuration de votre CMS (par exemple wp-config.php), par exemple après une migration ou une modification manuelle.
- Trop de connexions simultanées, souvent causées par un pic de visiteurs, un plugin qui ne ferme pas correctement ses connexions, ou une tâche cron qui se bloque.
- Droits expirés ou manquants pour l’utilisateur de base de données, par exemple après la création d’une nouvelle base de données sans lier correctement l’utilisateur.
- Un service de base de données arrêté ou en redémarrage sur le serveur, parfois en raison d’une maintenance ou d’un crash.
- Des requêtes longues ou inefficaces qui monopolisent le serveur et bloquent d’autres connexions.
Résolution étape par étape
Suivez les étapes ci-dessous dans l’ordre. Dans de nombreux cas, le problème est déjà trouvé à l’étape deux ou trois.
Vérifiez les identifiants de connexion
Ouvrez le fichier de configuration de votre site et comparez le nom de la base de données, le nom d’utilisateur, le mot de passe et le nom d’hôte avec les informations de votre panneau d’administration. Une simple faute de frappe ou un mot de passe expiré est une cause fréquente.
Vérifiez le nombre de connexions actives
Vérifiez via votre panneau d’hébergement ou phpMyAdmin combien de connexions sont ouvertes. En cas d’erreur « too many connections », vous pouvez temporairement fermer les processus obsolètes et examiner structurellement la cause du pic.
Vérifiez les droits d’utilisateur
Assurez-vous que l’utilisateur de la base de données dispose de droits complets sur la bonne base de données. Cela pose souvent problème après le déplacement d’un site web ou la restauration d’une sauvegarde.
Vérifiez si le service de base de données fonctionne
Regardez dans votre panneau d’administration si le service MySQL est actif. S’il est désactivé ou renvoie une erreur, contactez votre hébergeur pour faire redémarrer le service.
Analysez les requêtes lentes
Utilisez le journal des requêtes lentes (slow query log) pour voir quelles requêtes prennent du temps ou se bloquent. Optimisez ces requêtes ou ajoutez des index pour réduire la charge sur la base de données.
Prévenir les erreurs de connexion
Après avoir résolu une erreur ponctuelle, il est judicieux de prendre des mesures structurelles pour éviter que le problème ne se reproduise :
- Maintenez à jour les plugins, thèmes et versions du CMS, afin qu’ils ne maintiennent pas de connexions inutiles.
- Surveillez régulièrement le nombre de connexions à la base de données, surtout après une croissance du nombre de visiteurs.
- Utilisez la mise en cache pour réduire le nombre de requêtes à la base de données par affichage de page.
- Assurez-vous d’avoir des sauvegardes quotidiennes, afin de pouvoir rapidement revenir à une version fonctionnelle en cas de problème grave.
- Optez pour un environnement d’hébergement disposant d’une capacité suffisante, comme un stockage NVMe et des serveurs LiteSpeed, qui absorbent mieux les pics d’affluence qu’une infrastructure obsolète.
Chez Tandata, vous gérez vos bases de données via Plesk, où vous pouvez consulter les utilisateurs, les droits et les connexions actives dans un tableau de bord clair. Si vous doutez que votre environnement dispose d’une capacité suffisante, consultez les possibilités d’hébergement web ou découvrez comment passer chez Tandata si votre hébergeur actuel ne résout pas les problèmes structurels.
Si vous bloquez lors de l’analyse d’un message d’erreur, consultez la base de connaissances pour plus d’articles de fond ou contactez le support.
Questions fréquentes
Pourquoi est-ce que je reçois « too many connections » alors que mon site a peu de visiteurs ?
Cela indique généralement des connexions qui ne sont pas correctement fermées, par exemple à cause d’un plugin, d’une tâche cron ou d’un script défectueux. Vérifiez les processus actifs et fermez les connexions bloquées.
Puis-je moi-même augmenter le nombre maximal de connexions ?
Cela dépend de votre environnement d’hébergement et du type de forfait. En cas de doute, contactez votre hébergeur afin qu’il puisse évaluer si une augmentation est compatible avec les ressources du serveur.
Que signifie « access denied for user » ?
Cette erreur signifie que le nom d’utilisateur, le mot de passe ou les droits ne correspondent pas à la base de données. Vérifiez le fichier de configuration et les paramètres utilisateur dans votre panneau d’administration.
Comment éviter les erreurs de connexion après une migration ?
Après une migration, vérifiez toujours que l’utilisateur de la base de données est bien relié à la bonne base de données et que les identifiants dans le fichier de configuration ont été correctement mis à jour.
Une erreur de connexion est-elle dommageable pour mes données ?
Généralement pas directement, mais des erreurs prolongées peuvent entraîner des transactions échouées. Assurez-vous donc toujours de disposer de sauvegardes à jour.
Conclusion
Les erreurs de connexion MySQL se résolvent étape par étape : vérifiez les identifiants, examinez le nombre de connexions actives, contrôlez les droits d’utilisateur et vérifiez si le service de base de données fonctionne. En surveillant et en utilisant la mise en cache, vous évitez que le problème ne se reproduise.