...
Eroare Docker · Baze de date în containere

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

Pe scurt

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 run primeș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

Greșit
BASH
docker run --rm mysql:8 mysql -uroot -pSecret123 -e 'SHOW DATABASES'
Corect
BASH
docker exec db mysql -uroot -pSecret123 -e 'SHOW DATABASES'

exec rulează clientul lângă serverul care merge deja în db.

2Serverul nu e gata

Greșit
BASH
docker run -d --name db -e MYSQL_ROOT_PASSWORD=Secret123 mysql:8
docker exec db mysql -uroot -pSecret123 -e 'SELECT 1'
Corect
BASH
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

Greșit
BASH
docker run --rm --network magazin-net mysql:8 mysql -uroot -pSecret123
Corect
BASH
docker run --rm --network magazin-net mysql:8 mysql -h db -uroot -pSecret123

Cu -h db, clientul trece prin rețea la containerul bazei.

Repară tu

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.

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 directory
  • mysqladmin: 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

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.