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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Redis ține totul în memorie, iar maxmemory e plafonul. Când e atins, maxmemory-policy decide ce se întâmplă: noeviction (implicit) refuză orice comandă care ar adăuga date și întoarce OOM command not allowed when used memory > 'maxmemory'; politicile volatile-lru / volatile-ttl evacuează doar cheile cu TTL, deci dacă aplicația scrie chei fără expirare, nu au ce evacua și apare aceeași eroare; politicile allkeys-lru / allkeys-lfu evacuează orice cheie, alegând pe cele folosite rar.
Pentru un cache, pierderea unor chei e normală: valoarea se reîncarcă din bază. De aceea allkeys-lru (sau allkeys-lfu) e alegerea obișnuită. Pentru un Redis folosit ca depozit (sesiuni, cozi, contoare importante), evacuarea e periculoasă și ai nevoie de memorie suficientă și de monitorizare.
Calculează memoria: numărul de chei × mărimea medie, plus overhead-ul Redis.
De ce apare: cauzele frecvente
1Cache cu politica implicită noeviction
maxmemory 8gb
# maxmemory-policy noeviction (implicit)maxmemory 16gb
maxmemory-policy allkeys-lruCu allkeys-lru, Redis scoate cheile cel mai puțin folosite când se umple, iar scrierile continuă.
2Chei fără TTL cu politică volatile
redis.set('produs:42', valoare) # fără expirare
# maxmemory-policy volatile-lruredis.setex('produs:42', 3600, valoare)
# sau maxmemory-policy allkeys-lruPoliticile volatile-* pot evacua doar cheile cu TTL; fără ele, memoria nu se eliberează.
Repară eroarea, direct în pagină
Redis-ul de produse dă OOM command not allowed: are maxmemory de 8 GB, iar politica de evacuare e „doar TTL”, deși multe chei nu au expirare. Calculează în tab-ul Estimări câtă memorie ar ocupa toate cheile, apoi schimbă politica de evacuare a cache-ului ca Redis să poată elibera loc.
Indiciu
Pentru un cache, orice cheie poate fi scoasă și reîncărcată din bază.
Reparația
- Estimare: 12M × 1 KB ≈ 12 GB.
- Cache → Evacuare = LRU (echivalentul
maxmemory-policy allkeys-lru).
Rezultat: Redis evacuează cheile rar folosite în loc să refuze scrierile.
De ce merge
Cheile ar ocupa ~12 GB, peste limită, iar politica „doar TTL” nu poate evacua cheile fără expirare, deci Redis refuză scrierile. Cu LRU (sau LFU), Redis scoate cheile folosite rar și continuă să accepte scrieri.
Alte forme ale mesajului
OOM command not allowed when used memory > 'maxmemory'. script: ...redis.exceptions.OutOfMemoryError: OOM command not allowed when used memory > 'maxmemory'.io.lettuce.core.RedisCommandExecutionException: OOM command not allowed when used memory > 'maxmemory'.
Cum o eviți pe viitor
- Pentru cache, folosește
allkeys-lrusauallkeys-lfu. - Pune TTL pe cheile de cache.
- Estimează memoria (chei × mărime) și lasă rezervă.
- Ține separat Redis-ul de cache de cel cu date care nu au voie să dispară (sesiuni, cozi).
- Alertează pe
used_memoryfață demaxmemoryși pe numărul de evacuări.
Întrebări frecvente
Evacuarea nu strică aplicația?
Pentru un cache, nu: o cheie evacuată e o ratare, iar valoarea se reîncarcă. Dacă aplicația depinde de prezența cheii (o sesiune), Redis-ul nu e folosit ca un cache și are nevoie de altă configurare.
LRU sau LFU?
LRU păstrează cheile folosite recent; LFU pe cele folosite des. LFU e mai bun când câteva chei sunt mereu populare, iar o scanare ocazională a multor chei ar împinge afară cheile importante la LRU.
Erori înrudite
Rata de hit a cache-ului e mică (sub 50%), iar baza e tot supraîncărcată Cache-ul există, dar majoritatea citirilor tot ajung în bază: TTL-ul e prea scurt, cheile sunt prea specifice (conțin parametri care se schimbă), cache-ul e prea mic sau se invalidează prea des. Măsoară rata de hit, mărește TTL-ul acolo unde datele permit și normalizează cheile. 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. Write-behind: comenzi pierdute după căderea cache-ului Cu write-behind (write-back), scrierea e confirmată din cache și ajunge în bază mai târziu, grupată. Dacă nodul de cache cade înainte de salvare, modificările confirmate se pierd. Pentru date importante (comenzi, plăți), scrie sincron în bază (write-through sau cache-aside cu invalidare). Î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.
