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

MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017

Pe scurt

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

Greșit
BASH
docker run --rm --network magazin-net mongo:7 mongosh magazin
Corect
BASH
docker 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

Greșit
BASH
environment:
  MONGO_URL: mongodb://localhost:27017/magazin
Corect
BASH
environment:
  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ă

Greșit
BASH
docker run --rm -it mongo:7 mongosh
Corect
BASH
docker exec -it mongo mongosh magazin

exec rulează mongosh lângă serverul care merge deja.

Repară tu

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.

Alte forme ale mesajului

  • MongoServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017
  • MongoNetworkError: connect ECONNREFUSED 172.18.0.2:27017
  • MongooseServerSelectionError: 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

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