...
Eroare System Design · Servere supraîncărcate, scalare și sesiuni

OOMKilled (exit code 137): containerul e omorât pentru că depășește memoria

Pe scurt

Containerul a depășit limita de memorie, iar kernelul l-a oprit cu SIGKILL (137 = 128 + 9), fără ca aplicația să poată termina cererile în curs. Măsoară consumul real, lasă loc pentru memoria din afara heap-ului (`-XX:MaxRAMPercentage=75`), repară scurgerile și ajustează limita după date, nu după ghicit.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Kubernetes (OOMKilled în kubectl describe pod, Last State: Terminated, Reason: OOMKilled, Exit Code: 137) sau Docker, limita de memorie e impusă de kernel. La depășire, procesul nu primește o excepție prietenoasă: e omorât instant. Cererile în curs se pierd (clienții văd 502 sau resetări), iar pod-ul repornește, uneori în buclă (CrashLoopBackOff).

Cauze tipice: limita setată egal cu heap-ul (la Java, memoria totală e heap + metaspace + stive de thread-uri + buffere directe); încărcarea unor fișiere sau rezultate mari complet în memorie; cache-uri locale fără limită; scurgeri de memorie care cresc încet până la limită; mai multe procese (workeri) în același container.

Diagnostic: graficul memoriei containerului în timp. Dacă crește în trepte cu traficul, limita e mică; dacă urcă continuu și repornirea o resetează, e o scurgere.

De ce apare: cauzele frecvente

1Heap egal cu limita containerului

Greșit
resources:
  limits: { memory: 512Mi }
env:
  - { name: JAVA_OPTS, value: "-Xmx512m" }
Corect
resources:
  requests: { memory: 768Mi }
  limits: { memory: 768Mi }
env:
  - { name: JAVA_OPTS, value: "-XX:MaxRAMPercentage=75" }

Heap-ul ocupă 75% din limită, iar restul rămâne pentru memoria din afara lui.

2Fișier încărcat complet în memorie

Greșit
const continut = fs.readFileSync("export-2gb.csv");
Corect
fs.createReadStream("export-2gb.csv").pipe(transformare).pipe(raspuns);

Stream-ul procesează fișierul pe bucăți, cu memorie constantă.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre pod-urile repornite cu OOMKilled.

Indiciu

Heap-ul nu e toată memoria procesului.

Alte forme ale mesajului

  • Last State: Terminated, Reason: OOMKilled, Exit Code: 137
  • Memory cgroup out of memory: Killed process
  • java.lang.OutOfMemoryError: Java heap space

Cum o eviți pe viitor

  • Monitorizează memoria containerelor și alertează înainte de limită.
  • La Java, folosește MaxRAMPercentage în loc de -Xmx egal cu limita.
  • Procesează datele mari în stream-uri.
  • Pune limite pe cache-urile locale.
  • Investighează creșterile continue (heap dump, profiler).

Întrebări frecvente

Care e diferența față de OutOfMemoryError?

OutOfMemoryError vine din JVM, când heap-ul e plin, iar aplicația încă rulează. OOMKilled vine din kernel, când tot procesul depășește limita containerului, și oprește procesul instant.

requests sau limits?

requests e cât rezervă scheduler-ul, limits e plafonul. Pentru memorie, de obicei se pun egale, ca pod-ul să nu fie omorât când nodul are presiune de memorie.

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.