// Référence des erreurs MySQL

Erreur MySQL 2003 : Impossible de se connecter au serveur MySQL sur l'hôte

Le client n'a pas pu ouvrir une connexion TCP vers l'hôte et le port. Le serveur est arrêté, écoute ailleurs ou un pare-feu bloque la connexion.

Numéro d'erreur
2003
Nom
CR_CONN_HOST_ERROR
Catégorie
Connexion et client
Message d'erreur
Can't connect to MySQL server on '%s:%u' (%d)

Ce que cela signifie

2003 est levé par le client lorsque la connexion TCP elle-même échoue. Le nombre entre crochets est l'erreur du système d'exploitation : (111) ou (10061) sur Windows signifie connexion refusée (rien n'écoute), (110) ou (10060) signifie délai dépassé (généralement un pare-feu qui abandonne les paquets), et (113) signifie qu'il n'y a pas de route vers l'hôte.

Le serveur n'a jamais vu la connexion, donc le mot de passe et les privilèges n'ont pas encore d'importance.

Causes courantes

  • Le serveur ne fonctionne pas, ou écoute sur un autre port que 3306.
  • Le serveur n'écoute que sur 127.0.0.1 (bind_address), donc les connexions distantes sont refusées.
  • Un pare-feu, un groupe de sécurité ou une règle de réseau cloud bloque le port 3306.
  • Nom d'hôte ou adresse IP incorrect(e) dans les paramètres de connexion.

Comment le corriger

  1. Sur le serveur, vérifiez que MySQL fonctionne, et sur quelle adresse et quel port il écoute.

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. Pour accepter les connexions distantes, définissez bind_address = 0.0.0.0 (ou l'adresse IP du serveur lui-même) dans le [mysqld] section du fichier de configuration et redémarrez MySQL. Assurez-vous qu'un compte existe pour l'hôte distant.

  3. Ouvrez le port dans le pare-feu du serveur et dans tout groupe de sécurité cloud, puis testez depuis la machine cliente, par exemple avec nc -vz db.example.com 3306.

Erreurs liées

Plus d'erreurs de connexion et de client

Le code et le texte du message sont issus de Référence des messages d'erreur MySQL 8.4. Parcourir la liste complète Liste des erreurs MySQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur MySQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour MySQL et les autres bases de données que vous utilisez.