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

ERROR 2005 (HY000): Unknown MySQL server host 'db' (-2)

Pe scurt

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 mysql când containerul se numește db, sau numele containerului Compose magazin-db-1 în loc de numele serviciului db);
  • containerul bazei e oprit: un container oprit dispare din DNS;
  • rulezi clientul pe calculator, unde db nu înseamnă nimic (acolo folosești 127.0.0.1 și portul publicat).

De ce apare: cauzele frecvente

1Client în rețeaua implicită

Greșit
BASH
docker run --rm mysql:8 mysql -h db -uroot -pSecret123
Corect
BASH
docker 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

Greșit
BASH
docker run -d --name db --network date mysql:8
docker run -d --name api --network web api
Corect
BASH
docker network connect date api

Un container vede după nume doar containerele din rețelele lui.

3Clientul rulează pe calculator

Greșit
BASH
mysql -h db -uroot -p
Corect
BASH
mysql -h 127.0.0.1 -P 3306 -uroot -p   # cu -p 3306:3306 la docker run

De pe calculator ajungi la bază prin portul publicat, nu prin numele containerului.

Repară tu

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.

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 known
  • Error: 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

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