// Référence des erreurs MySQL

Erreur MySQL 2002 : Impossible de se connecter via le socket

Le client a essayé le socket Unix local et n'a trouvé aucun serveur. Le serveur n'est pas en cours d'exécution, utilise un autre chemin de socket, ou vous vouliez une connexion TCP.

Numéro d'erreur
2002
Nom
CR_CONNECTION_ERROR
Catégorie
Connexion et client
Message d'erreur
Can't connect to local MySQL server through socket '%s' (%d)

Ce que cela signifie

Lorsque vous vous connectez à localhost sur Unix, les clients MySQL utilisent un fichier de socket Unix au lieu de TCP. 2002 signifie que le fichier de socket n'existe pas ou que rien n'écoute dessus. Le nombre entre crochets est l'erreur du système d'exploitation, par exemple (2) pour aucun fichier de ce type et (111) pour connexion refusée.

Ceci est une erreur côté client : la requête n'a jamais atteint de serveur.

Causes courantes

  • Le serveur MySQL n'est pas en cours d'exécution, ou il a planté au démarrage.
  • Le socket du serveur se trouve à un endroit différent de celui attendu par le client (par exemple /var/run/mysqld/mysqld.sock contre /tmp/mysql.sock).
  • Le serveur fonctionne dans Docker ou sur une autre machine, donc il n'y a pas de socket local ; vous devez utiliser TCP.
  • Les autorisations sur le répertoire de sockets empêchent le client de l’atteindre.

Comment le corriger

  1. Vérifiez que le serveur est en cours d'exécution et lisez son journal des erreurs s'il ne l'est pas, par exemple avec systemctl status mysql sur Linux ou brew services list sur macOS.

  2. Connectez-vous via TCP au lieu du socket en utilisant 127.0.0.1 plutôt que localhost, ou --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. Si le serveur fonctionne localement, trouvez le chemin de son socket et indiquez-le au client.

    -- On the server:
    SHOW VARIABLES LIKE 'socket';
    -- Client:
    mysql --socket=/var/run/mysqld/mysqld.sock -u app -p

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.