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

OOM command not allowed when used memory > 'maxmemory'.

Pe scurt

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

Greșit
maxmemory 8gb
# maxmemory-policy noeviction (implicit)
Corect
maxmemory 16gb
maxmemory-policy allkeys-lru

Cu allkeys-lru, Redis scoate cheile cel mai puțin folosite când se umple, iar scrierile continuă.

2Chei fără TTL cu politică volatile

Greșit
redis.set('produs:42', valoare)         # fără expirare
# maxmemory-policy volatile-lru
Corect
redis.setex('produs:42', 3600, valoare)
# sau maxmemory-policy allkeys-lru

Politicile volatile-* pot evacua doar cheile cu TTL; fără ele, memoria nu se eliberează.

Repară tu

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

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-lru sau allkeys-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_memory față de maxmemory ș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

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