ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
Clientul mysql a încercat serverul local, prin socket, dar în containerul acela nu rulează niciun server (sau încă pornește). De obicei ai folosit docker run mysql mysql ... în loc de docker exec db mysql ..., sau te conectezi din alt container fără -h db. Așteaptă și pornirea completă a bazei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fără -h (sau cu -h localhost), clientul mysql se conectează prin socket-ul Unix /var/run/mysqld/mysqld.sock, la un server din același sistem. (2) e codul de sistem pentru „fișierul nu există”: nu există niciun server care să fi creat socket-ul.
În Docker, cauzele frecvente:
docker run --rm mysql:8 mysql -uroot -p...pornește un container nou, cu doar clientul;- clientul rulează în containerul aplicației, fără
-h db; - serverul încă se inițializează: la prima pornire, MySQL are nevoie de câteva secunde (chiar zeci de secunde) înainte să accepte conexiuni, iar o comandă rulată imediat după
docker runprimește 2002; - serverul s-a oprit (vezi
docker logs db).
Cu -h 127.0.0.1, clientul folosește TCP, iar eroarea devine 2003.
De ce apare: cauzele frecvente
1Container nou în loc de exec
docker run --rm mysql:8 mysql -uroot -pSecret123 -e 'SHOW DATABASES'docker exec db mysql -uroot -pSecret123 -e 'SHOW DATABASES'exec rulează clientul lângă serverul care merge deja în db.
2Serverul nu e gata
docker run -d --name db -e MYSQL_ROOT_PASSWORD=Secret123 mysql:8
docker exec db mysql -uroot -pSecret123 -e 'SELECT 1'until docker exec db mysqladmin ping -uroot -pSecret123 --silent; do sleep 2; done
docker exec db mysql -uroot -pSecret123 -e 'SELECT 1'Aștepți până când serverul răspunde, apoi rulezi comanda.
3Client în alt container
docker run --rm --network magazin-net mysql:8 mysql -uroot -pSecret123docker run --rm --network magazin-net mysql:8 mysql -h db -uroot -pSecret123Cu -h db, clientul trece prin rețea la containerul bazei.
Repară eroarea, direct în pagină
Containerul db (mysql:8, parola de root Secret123) rulează. Vrei să creezi în el baza rapoarte, dar docker run --rm mysql:8 mysql -uroot -pSecret123 -e 'CREATE DATABASE rapoarte' dă ERROR 2002 (HY000): Can't connect to local MySQL server through socket. Creează baza în containerul care rulează deja.
Indiciu
Comanda trebuie să ruleze în containerul db, nu într-un container nou.
Reparația
docker exec db mysql -uroot -pSecret123 -e 'CREATE DATABASE rapoarte'
docker exec db mysql -uroot -pSecret123 -e 'SHOW DATABASES'De ce merge
docker run pornea un container nou din imaginea mysql, cu doar clientul, iar acolo socket-ul /var/run/mysqld/mysqld.sock nu exista. docker exec db mysql ... rulează clientul în containerul în care merge serverul, conexiunea prin socket reușește, iar CREATE DATABASE rapoarte se execută.
Alte forme ale mesajului
ERROR 2002 (HY000): Can't connect to local server through socket '/run/mysqld/mysqld.sock' (2)SQLSTATE[HY000] [2002] No such file or directorymysqladmin: connect to server at 'localhost' failed
Cum o eviți pe viitor
Folosește docker exec pentru clientul din containerul bazei și -h numele_containerului pentru clienții din alte containere. În Compose, adaugă un healthcheck cu mysqladmin ping și depends_on: condition: service_healthy, ca aplicația să pornească abia când MySQL acceptă conexiuni. În aplicații, nu folosi localhost ca host pentru baza din alt container.
Întrebări frecvente
De ce primesc 2002 doar la prima pornire?
La prima pornire, imaginea inițializează baza, apoi repornește serverul. Între timp, socket-ul nu există. La pornirile următoare, serverul e gata mult mai repede.
Care e diferența dintre 2002 și 2003?
2002 e conexiunea prin socket local (fără -h sau cu localhost), 2003 e conexiunea prin TCP la un host și port. Ambele înseamnă că nu răspunde niciun server acolo.
Erori înrudite
ERROR 2003 (HY000): Can't connect to MySQL server on 'web:3306' (111) Numele s-a rezolvat, dar la adresa și portul acelea nu ascultă niciun server MySQL: (111) = Connection refused. Verifică host-ul (e containerul bazei?), portul (3306 în rețeaua Docker, portul publicat de pe calculator) și dacă serverul a terminat de pornit. ERROR 2005 (HY000): Unknown MySQL server host 'db' (-2) Numele de host dat la -h (db) nu se poate rezolva la o adresă IP. În Docker, înseamnă aproape mereu că clientul nu e în aceeași rețea cu containerul bazei: rețeaua implicită bridge nu are DNS după nume. Pune ambele containere într-o rețea proprie (--network magazin-net) sau în același proiect Compose. psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory psql s-a conectat local, prin socket, într-un container în care nu rulează niciun server PostgreSQL. De obicei ai pornit un container nou (docker run postgres psql) în loc să intri în cel existent: folosește docker exec db psql -U postgres, sau dă -h cu numele containerului bazei. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
