...
Eroare System Design · Cache: stampede, date vechi, memorie plină

ERR max number of clients reached

Pe scurt

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

Greșit
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}`)));
});
Corect
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ță

Greșit
spring.data.redis.lettuce.pool.max-active=300   # × 40 instanțe
Corect
spring.data.redis.lettuce.pool.max-active=16

Câteva conexiuni ajung pentru un server care face comenzi de microsecunde.

Repară tu

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.

Alte forme ale mesajului

  • redis.exceptions.ConnectionError: max number of clients reached
  • ReplyError: 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

← Toate erorile System Design

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ță 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.