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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Clientul a obținut IP-ul pentru host (deci nu e 2005) și a încercat o conexiune TCP pe port. (111) e ECONNREFUSED: mașina există, dar nimic nu ascultă pe acel port. Dacă vezi (110), conexiunea a expirat (firewall, IP greșit).
În Docker, cauzele frecvente:
- host greșit:
DB_HOST=websauapiîn loc dedb(containerul există, dar nu e MySQL); - port greșit: în rețeaua Docker se folosește portul containerului (3306), nu cel publicat pe calculator (
-p 3307:3306); - serverul încă se inițializează sau a căzut (vezi
docker logs db); - de pe calculator, portul nu e publicat (
-p 3306:3306lipsă); localhost/127.0.0.1în containerul aplicației: acolo înseamnă chiar containerul aplicației.
De ce apare: cauzele frecvente
1Host greșit
docker run --rm --network magazin-net -e DB_HOST=web apidocker run --rm --network magazin-net -e DB_HOST=mysql-db apiHost-ul trebuie să fie containerul în care rulează MySQL.
2Portul publicat folosit în rețeaua Docker
# db pornit cu -p 3307:3306
mysql -h db -P 3307 -uroot -pmysql -h db -P 3306 -uroot -pÎntre containere se folosește portul din container; 3307 există doar pe calculator.
3localhost în containerul aplicației
DATABASE_URL=mysql://root:Secret123@127.0.0.1:3306/magazinDATABASE_URL=mysql://root:Secret123@db:3306/magazinÎn container, 127.0.0.1 e containerul însuși, unde nu rulează MySQL.
Repară eroarea, direct în pagină
În rețeaua magazin-net rulează front-end-ul web (nginx) și baza mysql-db (mysql:8, parola de root Secret123). Scriptul de raportare folosește -h web și cade cu ERROR 2003 (HY000): Can't connect to MySQL server on 'web:3306' (111). Rulează clientul din magazin-net cu host-ul corect și creează prin el baza rapoarte.
Indiciu
Host-ul trebuie să fie containerul în care rulează MySQL.
Reparația
docker run --rm --network magazin-net mysql:8 mysql -h mysql-db -uroot -pSecret123 -e 'CREATE DATABASE rapoarte'
docker exec mysql-db mysql -uroot -pSecret123 -e 'SHOW DATABASES'De ce merge
web există în rețea, deci numele se rezolva, dar pe portul 3306 al lui nginx nu asculta nimic, așa că conexiunea era refuzată (111). Cu -h mysql-db, clientul ajunge la containerul în care serverul MySQL ascultă pe 3306, autentificarea reușește, iar CREATE DATABASE rapoarte rulează.
Alte forme ale mesajului
ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:3306' (111)ERROR 2003 (HY000): Can't connect to MySQL server on 'db:3306' (110)Error: connect ECONNREFUSED 172.18.0.3:3306
Cum o eviți pe viitor
Păstrează datele de conexiune într-un singur loc (.env) și folosește ca host numele serviciului bazei. Între containere, portul e mereu cel din container (3306 la MySQL). Adaugă un healthcheck bazei și depends_on: condition: service_healthy, ca aplicația să nu se conecteze înainte ca serverul să fie gata.
Întrebări frecvente
Cum verific ce ascultă pe un port într-un container?
docker exec db ss -tln (dacă există ss) sau, mai simplu, docker logs db: MySQL scrie port: 3306 când e gata să accepte conexiuni.
Care e diferența dintre 2003 și 2005?
La 2005, numele host-ului nu s-a putut rezolva deloc. La 2003, s-a găsit o adresă, dar acolo nu răspunde niciun server MySQL.
Erori înrudite
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. 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. curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server Pe calculator nu ascultă nimic pe portul 8080: containerul nu publică portul (lipsește -p 8080:80), e oprit sau portul din dreapta nu e cel pe care ascultă aplicația. Verifică cu docker ps coloana PORTS și recreează containerul cu -p 8080:80. Î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.
