// MySQL-Fehlerreferenz

MySQL-Fehler 2002: Verbindung über Socket nicht möglich

Der Client hat den lokalen Unix-Socket probiert und dort keinen Server gefunden. Der Server läuft nicht, benutzt einen anderen Socket-Pfad, oder du wolltest eine TCP-Verbindung.

Fehlernummer
2002
Name
CR_CONNECTION_ERROR
Kategorie
Verbindung und Client
Fehlermeldung
Can't connect to local MySQL server through socket '%s' (%d)

Was es bedeutet

Wenn du eine Verbindung herstellst zu localhost Unter Unix verwenden MySQL-Clients eine Unix-Socket-Datei anstelle von TCP. 2002 bedeutet, dass die Socket-Datei nicht existiert oder nichts darauf lauscht. Die Zahl in Klammern ist der Betriebssystemfehler, zum Beispiel (2) für eine fehlende Datei und (111) für Verbindung verweigert.

Das ist ein Client-Fehler: Die Anfrage hat nie einen Server erreicht.

Häufige Ursachen

  • Der MySQL-Server läuft nicht oder ist beim Start abgestürzt.
  • Die Socket-Datei des Servers befindet sich an einem anderen Ort als vom Client erwartet (zum Beispiel /var/run/mysqld/mysqld.sock gegenüber /tmp/mysql.sock).
  • Der Server läuft in Docker oder auf einer anderen Maschine, also gibt es keinen lokalen Socket; du brauchst TCP.
  • Die Berechtigungen im Socket-Verzeichnis verhindern, dass der Client darauf zugreifen kann.

Wie du es behebst

  1. Stelle sicher, dass der Server läuft, und lies sonst sein Fehlerprotokoll, zum Beispiel mit systemctl status mysql unter Linux oder brew services list unter macOS.

  2. Verbinde dich über TCP statt über den Socket, indem du 127.0.0.1 anstelle von localhost, oder --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. Läuft der Server lokal, finde seinen Socket-Pfad und verweise den Client darauf.

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

Zugehörige Fehler

Weitere Verbindungs- und Clientfehler

Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit MySQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für MySQL und die anderen Datenbanken, mit denen du arbeitest.