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

ERROR 2003 (HY000): Can't connect to MySQL server on 'web:3306' (111)

Pe scurt

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=web sau api în loc de db (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:3306 lipsă);
  • localhost / 127.0.0.1 în containerul aplicației: acolo înseamnă chiar containerul aplicației.

De ce apare: cauzele frecvente

1Host greșit

Greșit
BASH
docker run --rm --network magazin-net -e DB_HOST=web api
Corect
BASH
docker run --rm --network magazin-net -e DB_HOST=mysql-db api

Host-ul trebuie să fie containerul în care rulează MySQL.

2Portul publicat folosit în rețeaua Docker

Greșit
BASH
# db pornit cu -p 3307:3306
mysql -h db -P 3307 -uroot -p
Corect
BASH
mysql -h db -P 3306 -uroot -p

Între containere se folosește portul din container; 3307 există doar pe calculator.

3localhost în containerul aplicației

Greșit
BASH
DATABASE_URL=mysql://root:Secret123@127.0.0.1:3306/magazin
Corect
BASH
DATABASE_URL=mysql://root:Secret123@db:3306/magazin

În container, 127.0.0.1 e containerul însuși, unde nu rulează MySQL.

Repară tu

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.

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

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