MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Clientul (mongosh sau aplicația) încearcă MongoDB pe 127.0.0.1, adică în propriul container, unde nu rulează niciun server. Folosește numele containerului bazei în conexiune (mongodb://mongo:27017/magazin), cu ambele containere în aceeași rețea, sau rulează mongosh cu docker exec în containerul bazei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ECONNREFUSED 127.0.0.1:27017 înseamnă că la adresa locală, pe portul implicit al MongoDB, nu ascultă nimic. Fără un connection string, mongosh și majoritatea driverelor folosesc mongodb://127.0.0.1:27017.
Într-un container, 127.0.0.1 este chiar acel container. Când rulezi docker run --rm mongo mongosh sau aplicația ta în alt container cu MONGO_URL=mongodb://localhost:27017, conexiunea nu ajunge la containerul bazei, ci rămâne în containerul curent, unde nu există server.
Alte cauze: containerul mongo e oprit sau încă pornește; ai publicat alt port pe calculator (-p 27018:27017) și te conectezi de pe calculator la 27017; ori aplicația a pornit înaintea bazei, fără reîncercare. Dacă adresa din mesaj e un IP de rețea Docker (172.18.x.x), host-ul e bun, dar serverul nu răspunde.
De ce apare: cauzele frecvente
1mongosh într-un container nou
docker run --rm --network magazin-net mongo:7 mongosh magazindocker run --rm --network magazin-net mongo:7 mongosh "mongodb://mongo:27017/magazin"Connection string-ul cu host-ul mongo duce la containerul bazei, nu la 127.0.0.1.
2localhost în aplicație
environment:
MONGO_URL: mongodb://localhost:27017/magazinenvironment:
MONGO_URL: mongodb://mongo:27017/magazinÎn Compose, serviciul bazei se găsește după nume în rețeaua proiectului.
3Doar vrei un shell în bază
docker run --rm -it mongo:7 mongoshdocker exec -it mongo mongosh magazinexec rulează mongosh lângă serverul care merge deja.
Repară eroarea, direct în pagină
Baza mongo (mongo:7) rulează în rețeaua magazin-net. Un container de import pornit cu docker run --rm --network magazin-net mongo:7 mongosh magazin --eval ... cade cu MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017. Rulează importul cu un connection string care duce la containerul mongo și inserează în colecția produse documentul {nume: "paine"}.
Indiciu
Dă-i lui mongosh adresa completă: mongodb://mongo:27017/magazin.
Reparația
docker run --rm --network magazin-net mongo:7 mongosh "mongodb://mongo:27017/magazin" --quiet --eval 'db.produse.insertOne({nume: "paine"})'
docker exec mongo mongosh magazin --quiet --eval 'db.produse.countDocuments()'1De ce merge
Fără connection string, mongosh se conecta la 127.0.0.1:27017, adică în containerul de import, unde nu rulează niciun server. Cu mongodb://mongo:27017/magazin, DNS-ul rețelei magazin-net rezolvă mongo la containerul bazei, conexiunea reușește, iar insertOne scrie documentul în baza magazin. Aceeași adresă o pui și în variabila MONGO_URL a aplicației.
Alte forme ale mesajului
MongoServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017MongoNetworkError: connect ECONNREFUSED 172.18.0.2:27017MongooseServerSelectionError: connect ECONNREFUSED ::1:27017
Cum o eviți pe viitor
În containere, nu folosi niciodată localhost pentru servicii din alte containere: pune numele serviciului în connection string și ține-l într-o variabilă de mediu (MONGO_URL). Pornește aplicația și baza în aceeași rețea sau în același proiect Compose și adaugă reîncercări la conectare, ca ordinea de pornire să nu conteze.
Întrebări frecvente
De ce mesajul arată ::1 în loc de 127.0.0.1?
localhost se poate rezolva la adresa IPv6 ::1. E aceeași problemă: conexiunea rămâne în containerul curent. Soluția e numele containerului bazei.
De pe calculator, ce adresă folosesc?
Dacă ai publicat portul (-p 27017:27017), mongodb://localhost:27017 merge de pe calculator. Doar din alte containere folosești numele serviciului.
Erori înrudite
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. 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. Î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.
