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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Redis e single-threaded pentru comenzi și răspunde în microsecunde, deci are nevoie de puține conexiuni. Totuși, fiecare client conectat consumă un descriptor de fișier și memorie. Limita maxclients (implicit 10.000, redusă automat dacă sistemul permite mai puțini descriptori) e atinsă mai ales în două situații.
Prima: scalare. Fiecare instanță a aplicației are un pool, iar zeci de instanțe cu pool-uri mari (sute de conexiuni) trec de limită. A doua: leak. Codul creează un client nou la fiecare cerere (new Redis() în handler) și nu îl închide, iar conexiunile se adună până la limită. Funcțiile serverless sunt predispuse la a doua problemă.
INFO clients arată connected_clients, iar CLIENT LIST arată de unde vin conexiunile și cât stau inactive. Setarea timeout închide conexiunile inactive.
De ce apare: cauzele frecvente
1Client nou la fiecare cerere
app.get('/produs/:id', async (req, res) => {
const redis = new Redis(process.env.REDIS_URL);
res.json(JSON.parse(await redis.get(`produs:${req.params.id}`)));
});const redis = new Redis(process.env.REDIS_URL); // o dată, la pornire
app.get('/produs/:id', async (req, res) => {
res.json(JSON.parse(await redis.get(`produs:${req.params.id}`)));
});Un singur client (sau un pool mic) per proces e refolosit de toate cererile.
2Pool mare pe fiecare instanță
spring.data.redis.lettuce.pool.max-active=300 # × 40 instanțespring.data.redis.lettuce.pool.max-active=16Câteva conexiuni ajung pentru un server care face comenzi de microsecunde.
Repară eroarea, direct în pagină
Aplicația are 40 de instanțe, fiecare cu un pool de 300 de conexiuni Redis, iar Redis răspunde ERR max number of clients reached (limita: 10.000). Fă cele două calcule din tab-ul Estimări.
Indiciu
Conexiunile totale sunt instanțe × pool.
Reparația
- e1: 40 × 300 = 12.000 de conexiuni.
- e2: 8.000 / 40 = 200 pe instanță.
De ce merge
40 × 300 = 12.000 de conexiuni, peste limita de 10.000. Cu un pool de 200 (sau mai mic), totalul rămâne sub 8.000, cu rezervă pentru alte servicii.
Alte forme ale mesajului
redis.exceptions.ConnectionError: max number of clients reachedReplyError: ERR max number of clients reached
Cum o eviți pe viitor
- Creează clientul Redis o singură dată per proces.
- Ține pool-urile mici și calculează totalul pentru toate instanțele.
- Setează
timeoutîn Redis pentru conexiunile inactive. - Monitorizează
connected_clients.
Întrebări frecvente
Să măresc maxclients?
Poți, dacă sistemul permite destui descriptori, dar dacă problema e un leak, doar amâni momentul. Verifică întâi CLIENT LIST.
De ce Redis are nevoie de așa puține conexiuni?
Pentru că execută comenzile foarte repede, pe rând. O conexiune poate trimite zeci de mii de comenzi pe secundă, mai ales cu pipelining.
Erori înrudite
FATAL: sorry, too many clients already PostgreSQL a atins `max_connections` (implicit 100) și refuză conexiuni noi. Apare tipic după scalarea aplicației: fiecare instanță are propriul pool, iar suma lor depășește limita. Calculează instanțe × mărimea pool-ului, micșorează pool-urile și pune un pooler (PgBouncer) în față. 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. OOM command not allowed when used memory > 'maxmemory'. Redis a ajuns la limita `maxmemory` și, cu politica de evacuare curentă (`noeviction` sau `volatile-*` fără chei cu TTL), nu poate elibera loc, așa că refuză scrierile. Pentru un cache, alege o politică precum `allkeys-lru`, pune TTL pe chei și dimensionează memoria după calcul. Î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.
