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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Clientul MySQL a încercat să afle IP-ul pentru db și n-a reușit: (-2) e codul pentru „numele nu e cunoscut” (EAI_NONAME). Spre deosebire de 2003, aici conexiunea nici n-a început, pentru că nu există o adresă.
În Docker, numele containerelor se rezolvă doar prin DNS-ul rețelelor proprii (create cu docker network create sau de Compose). Cauzele frecvente:
- clientul sau aplicația rulează în rețeaua implicită
bridge, fără DNS; - baza e într-o rețea, iar aplicația în alta;
- numele e greșit (
-h mysqlcând containerul se numeștedb, sau numele containerului Composemagazin-db-1în loc de numele serviciuluidb); - containerul bazei e oprit: un container oprit dispare din DNS;
- rulezi clientul pe calculator, unde
dbnu înseamnă nimic (acolo folosești127.0.0.1și portul publicat).
De ce apare: cauzele frecvente
1Client în rețeaua implicită
docker run --rm mysql:8 mysql -h db -uroot -pSecret123docker run --rm --network magazin-net mysql:8 mysql -h db -uroot -pSecret123În rețeaua magazin-net, DNS-ul Docker rezolvă numele db.
2Containere în rețele diferite
docker run -d --name db --network date mysql:8
docker run -d --name api --network web apidocker network connect date apiUn container vede după nume doar containerele din rețelele lui.
3Clientul rulează pe calculator
mysql -h db -uroot -pmysql -h 127.0.0.1 -P 3306 -uroot -p # cu -p 3306:3306 la docker runDe pe calculator ajungi la bază prin portul publicat, nu prin numele containerului.
Repară eroarea, direct în pagină
Baza db (mysql:8, parola de root Secret123) rulează în rețeaua magazin-net. Un container client pornit cu docker run --rm mysql:8 mysql -h db ... dă ERROR 2005 (HY000): Unknown MySQL server host 'db'. Rulează clientul astfel încât să găsească baza după nume și creează prin el baza arhiva.
Indiciu
Clientul trebuie să fie în aceeași rețea cu db: --network magazin-net.
Reparația
docker run --rm --network magazin-net mysql:8 mysql -h db -uroot -pSecret123 -e 'CREATE DATABASE arhiva'
docker exec db mysql -uroot -pSecret123 -e 'SHOW DATABASES'De ce merge
Clientul pornea în rețeaua implicită bridge, care nu are DNS după nume, deci db nu se rezolva. Cu --network magazin-net, containerul client folosește DNS-ul încorporat al rețelei, care întoarce IP-ul lui db. Conexiunea TCP pe portul 3306 reușește, iar CREATE DATABASE arhiva rulează pe serverul din db.
Alte forme ale mesajului
ERROR 2005 (HY000): Unknown MySQL server host 'mysql' (-3)SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo for db failed: Name or service not knownError: getaddrinfo ENOTFOUND db
Cum o eviți pe viitor
Pornește aplicația și baza în aceeași rețea proprie sau în același proiect Compose și folosește ca host numele serviciului (db). Verifică rapid rezolvarea din containerul aplicației cu getent hosts db sau nslookup db. Pentru conexiuni de pe calculator, publică portul și folosește 127.0.0.1.
Întrebări frecvente
De ce în rețeaua bridge implicită numele nu merg?
Din motive istorice, rețeaua bridge implicită nu are DNS între containere. Orice rețea creată de tine (sau de Compose) are DNS-ul încorporat, la 127.0.0.11.
Ce înseamnă -2 sau -3 de la final?
Sunt coduri ale funcției de rezolvare a numelor: -2 = numele nu există, -3 = eroare temporară (de exemplu DNS indisponibil). Ambele înseamnă că nu s-a obținut un IP.
Erori înrudite
ping: bad address 'cache' Containerul nu poate traduce numele altui container în adresă IP, pentru că sunt pe rețeaua bridge implicită, unde Docker nu oferă DNS după nume. Creează o rețea proprie (docker network create magazin) și leagă ambele containere de ea; acolo numele containerelor se rezolvă automat. 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. docker: Error response from daemon: network magazin-net not found. Rețeaua dată la --network nu există pe acest daemon: n-a fost creată încă, are alt nume sau a fost ștearsă. Creeaz-o cu docker network create magazin-net (sau verifică numele cu docker network ls), apoi pornește containerul. Î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.
