Error: connect ECONNREFUSED 127.0.0.1:6379
Aplicația încearcă să se conecteze la Redis pe mașina locală (127.0.0.1, portul 6379), dar acolo nu rulează niciun Redis. Pe un singur calculator merge, pe mai multe servere nu: Redis trebuie să fie un serviciu separat, comun, iar aplicația primește adresa lui din configurație.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la clientul Redis din Node.js (redis, ioredis), iar ECONNREFUSED înseamnă că la adresa respectivă nu ascultă nimic. 127.0.0.1 e chiar mașina (sau containerul) pe care rulează aplicația, iar 6379 e portul implicit Redis.
În dezvoltare, Redis rulează pe laptop și adresa implicită merge. În producție, cu mai multe instanțe ale aplicației, fiecare container are propriul 127.0.0.1, unde nu există Redis. Chiar dacă ai porni câte un Redis pe fiecare server, sesiunile și cache-ul nu ar mai fi comune: fiecare instanță ar avea datele ei.
În Docker Compose și Kubernetes, alt serviciu se adresează prin numele lui (redis:6379), nu prin localhost. Verifică variabila de mediu cu adresa Redis (REDIS_URL) și dacă serviciul Redis chiar există și e accesibil din rețeaua aplicației.
De ce apare: cauzele frecvente
1Adresa Redis lăsată implicită
const client = createClient(); // redis://127.0.0.1:6379
await client.connect();const client = createClient({ url: process.env.REDIS_URL });
// REDIS_URL=redis://redis.intern:6379
await client.connect();Adresa vine din configurație, deci aceeași imagine merge local și în producție, iar toate instanțele folosesc același Redis.
2localhost în Docker Compose
services:
app:
environment:
REDIS_URL: redis://localhost:6379
redis:
image: redis:7services:
app:
environment:
REDIS_URL: redis://redis:6379
redis:
image: redis:7În containerul app, localhost e containerul însuși. Serviciul Redis se găsește prin numele lui din Compose.
Repară eroarea, direct în pagină
Serverele sunt configurate să țină sesiunile în Redis, dar nu există niciun Redis comun în arhitectură, iar logurile arată ECONNREFUSED 127.0.0.1:6379. Adaugă depozitul de sesiuni comun și leagă-l de servere.
Indiciu
Avertismentul din tab-ul Simulare spune exact ce lipsește serverului.
Reparația
1. Adaugă Cache (Redis). 2. Conectează Server aplicație → Cache (Redis).
Rezultat: avertismentul despre depozitul de sesiuni dispare.
De ce merge
Setarea „sesiuni în cache” nu ajută dacă serverul nu e conectat la un cache. Cu un Redis comun, conectat de la server, toate instanțele scriu și citesc sesiunile în același loc.
Alte forme ale mesajului
Error: connect ECONNREFUSED ::1:6379redis.exceptions.ConnectionError: Error 111 connecting to localhost:6379. Connection refused.Unable to connect to Redis; nested exception is io.lettuce.core.RedisConnectionException: Unable to connect to localhost:6379
Cum o eviți pe viitor
- Citește adresele serviciilor (Redis, baza de date) din variabile de mediu, niciodată hardcodate.
- Într-o arhitectură cu mai multe instanțe, Redis e un serviciu separat, comun, eventual cu replică.
- Verifică la pornire conexiunea și oprește aplicația cu un mesaj clar dacă lipsește.
- În Compose și Kubernetes folosește numele serviciilor, nu
localhost.
Întrebări frecvente
De ce merge pe laptop și nu în container?
Pe laptop Redis rulează chiar pe mașina ta, deci 127.0.0.1 e corect. În container, 127.0.0.1 înseamnă containerul aplicației, unde nu rulează Redis.
Apare ::1:6379 în loc de 127.0.0.1. E altceva?
Nu, ::1 e adresa locală în IPv6. Node.js 17+ poate rezolva localhost întâi la IPv6. Cauza și soluția sunt aceleași.
Erori înrudite
Utilizatorii sunt delogați aleatoriu după ce ai adăugat al doilea server Sesiunile sunt ținute în memoria fiecărui server, iar load balancer-ul trimite cererile următoare la alt server, care nu cunoaște sesiunea, deci utilizatorul pare delogat sau coșul se golește. Mută sesiunile într-un loc comun (Redis) sau folosește tokenuri, ca serverele să fie stateless. connect() failed (111: Connection refused) while connecting to upstream nginx a încercat să deschidă o conexiune spre server și a primit refuz imediat: la adresa și portul din configurație nu ascultă niciun proces. Verifică dacă aplicația rulează, pe ce port ascultă și dacă `proxy_pass` / upstream-ul indică exact acea adresă. ERR max number of clients reached Redis a atins `maxclients` (implicit 10.000) și refuză conexiuni noi. Cauza obișnuită e suma pool-urilor tuturor instanțelor sau conexiuni deschise la fiecare cerere și neînchise. Calculează instanțe × pool, folosește pool-uri mici și închide conexiunile. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
