So sieht die Meldung aus
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)Häufige Ursachen
- Der Datenbankdienst läuft nicht: gestoppt, abgestürzt oder vom OOM-Killer beendet.
- Der Server ist nicht gestartet, weil die Platte voll ist oder das Datenverzeichnis beschädigt ist bzw. falsche Rechte hat.
- Client und Server nutzen unterschiedliche Socket-Pfade, z. B.
/run/mysqld/mysqld.sockund/var/lib/mysql/mysql.sock. - Die Anwendung verbindet sich zu
localhost, das heißt über den Socket, der Server lauscht aber nur auf TCP. - Eine zweite Instanz oder ein Container nutzt einen anderen Socket.
Prüfen
- Läuft der Dienst?
systemctl status mariadb - Warum wurde er beendet? Die letzten Logzeilen lesen
- Existiert der Socket?
ls -l /run/mysqld/ - Ist Platz für das Datenverzeichnis frei?
df -h /var/lib/mysql
Lösung
- Dienst starten und lesen, warum er stand:
systemctl start mariadb. Bei MySQL heißt die Unitmysql. - Speicherplatz freigeben bzw. die Rechte auf
/var/lib/mysqlreparieren, falls das der Grund war. - Hat der OOM-Killer ihn beendet, den Speicherbedarf senken (
innodb_buffer_pool_size) oder RAM ergänzen. - In den Abschnitten
[client]und[mysqld]der Konfiguration denselben Socket-Pfad verwenden. - In der Anwendung
127.0.0.1und Port 3306 stattlocalhosteintragen, um über TCP zu verbinden.
Typisches Szenario
Du hast eine PHP-Anwendung in einen Docker-Container verschoben, die Datenbank läuft weiter auf dem Host. Die Konfiguration enthält noch DB_HOST=localhost, und die Seite zeigt Fehler 2002 mit dem Pfad /var/run/mysqld/mysqld.sock. Im Container existiert diese Socket-Datei nicht, denn sie liegt im Dateisystem des Hosts. Prüfe zuerst, ob der Client überhaupt auf demselben System läuft wie der Server, und stelle den Host auf eine IP-Adresse um.
Häufige Fragen
Was ist hier der Unterschied zwischen localhost und 127.0.0.1?
Bei localhost nutzt der MySQL-Client die Unix-Socket-Datei. Bei 127.0.0.1 nutzt er TCP. Fehlt der Socket, TCP funktioniert aber, erklärt das genau diesen Fehler.
Welcher Fehler kommt bei falschem Passwort?
Das ist ERROR 1045. Fehler 2002 kommt früher: Der Client erreicht den Server gar nicht erst.
Warum tritt der Fehler direkt nach einem Neustart auf, obwohl vorher alles lief?
Die Socket-Datei liegt meist in /run, einem flüchtigen Verzeichnis, und wird erst beim Start des Servers angelegt. Kommt der Dienst nach dem Boot nicht hoch, etwa wegen eines noch nicht eingehängten Datenträgers oder voller Platte, gibt es keine Socket-Datei und damit Fehler 2002.
Sind meine Daten weg, wenn Fehler 2002 erscheint?
Nein. Der Fehler sagt nur, dass am erwarteten Pfad kein Server antwortet. Die Daten liegen im Datenverzeichnis, meist /var/lib/mysql, und sind unberührt. Prüfe dort den Platz und die Rechte, bevor du irgendetwas löschst oder neu initialisierst.
Woher weiß ich, welchen Socket-Pfad mein Client erwartet?
Das Kommandozeilen-Tool zeigt ihn mit mysql --help | grep -i socket. Bei PHP bestimmen mysqli.default_socket und pdo_mysql.default_socket den Pfad. Der Server nutzt den Wert socket aus dem Abschnitt [mysqld]; beide müssen übereinstimmen.