...
Eroare Java · Stiva de apeluri, tablouri și încărcarea claselor

java.lang.OutOfMemoryError: Java heap space

Pe scurt

Programul a cerut mai multă memorie decât are JVM-ul la dispoziție: un tablou uriaș, o colecție care crește fără limită sau date încărcate integral în memorie. Repară cauza (dimensiuni, bucle, cache-uri); mărirea memoriei cu -Xmx ajută doar dacă programul chiar are nevoie de ea.

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

Ce înseamnă

Obiectele Java trăiesc într-o zonă de memorie numită heap, cu o dimensiune maximă stabilită la pornire (implicit, o fracțiune din memoria calculatorului; o setezi cu -Xmx). Când programul cere un obiect nou, iar colectorul de gunoi (garbage collector) nu mai poate elibera destul loc, JVM-ul aruncă OutOfMemoryError: Java heap space.

Cauzele frecvente:

  • un tablou sau o colecție creată cu o dimensiune uriașă, de multe ori dintr-un calcul greșit;
  • o buclă care adaugă la nesfârșit într-o listă sau un Map (de exemplu, o condiție de oprire greșită);
  • un cache static care nu șterge niciodată nimic;
  • citirea unui fișier sau a unui rezultat SQL întreg în memorie.

Linia din stivă arată unde s-a cerut memoria, nu neapărat cine a ocupat-o. Pentru aplicații mari, analizezi un heap dump (-XX:+HeapDumpOnOutOfMemoryError) cu VisualVM sau Eclipse MAT.

De ce apare: cauzele frecvente

1Tablou dimensionat după valoarea maximă posibilă

Greșit
JAVA
// ID-urile produselor pot ajunge la 2 miliarde
long[] stocPeId = new long[2_000_000_000];
Corect
JAVA
Map<Integer, Long> stocPeId = new HashMap<>();
stocPeId.put(1_500_000_123, 40L);

Un Map ține doar produsele care există, nu câte o poziție pentru fiecare ID posibil.

2Buclă care nu se oprește

Greșit
JAVA
List<Integer> numere = new ArrayList<>();
int i = 0;
while (i < 10) {
    numere.add(i);
}
Corect
JAVA
List<Integer> numere = new ArrayList<>();
int i = 0;
while (i < 10) {
    numere.add(i);
    i++;
}

Fără i++, condiția rămâne adevărată, iar lista crește până se termină memoria.

3Cache static fără limită

Greșit
JAVA
static Map<String, byte[]> cache = new HashMap<>();
// la fiecare cerere: cache.put(url, continut);
Corect
JAVA
static Map<String, byte[]> cache = new LinkedHashMap<>(16, 0.75f, true) {
    protected boolean removeEldestEntry(Map.Entry<String, byte[]> e) {
        return size() > 100;
    }
};

Un cache trebuie să aibă limită. Aici, peste 100 de intrări se șterge cea mai veche folosită.

Repară tu

Repară eroarea, direct în pagină

Programul ține stocul produselor într-un tablou cu câte o poziție pentru fiecare ID posibil (până la 2 miliarde) și se oprește cu OutOfMemoryError: Java heap space. Folosește un Map care ține doar produsele existente, ca programul să afișeze Stoc 1500000123: 40 și Produse urmarite: 2.

Codul care dă eroarea
JAVA
public class Main {
    public static void main(String[] args) {
        long[] stocPeId = new long[2_000_000_000];
        stocPeId[1_500_000_123] = 40;
        stocPeId[17] = 5;
        System.out.println("Stoc 1500000123: " + stocPeId[1_500_000_123]);
        System.out.println("Produse urmarite: 2");
    }
}
După reparație, programul afișează
Stoc 1500000123: 40
Produse urmarite: 2
Indiciu

Înlocuiește tabloul cu Map<Integer, Long> și folosește put / get.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.OutOfMemoryError: Java heap space
  • java.lang.OutOfMemoryError: Requested array size exceeds VM limit
  • java.lang.OutOfMemoryError: GC overhead limit exceeded
  • java.lang.OutOfMemoryError: Metaspace

Cum o eviți pe viitor

  • Verifică dimensiunile calculate înainte să creezi tablouri mari.
  • Pune limită oricărui cache și oricărei cozi care primește date din exterior.
  • Procesează fișierele mari și rezultatele SQL pe bucăți (citire linie cu linie, paginare), nu integral.
  • În producție, pornește aplicația cu -XX:+HeapDumpOnOutOfMemoryError, ca să poți analiza ce a ocupat memoria.
  • Mărește -Xmx doar după ce știi că programul chiar are nevoie de mai multă memorie.

Întrebări frecvente

E suficient să măresc -Xmx?

Doar dacă programul are nevoie legitim de mai multă memorie. Dacă e o scurgere (o colecție care crește la nesfârșit), cu mai multă memorie eroarea apare doar mai târziu.

Pot prinde OutOfMemoryError cu catch?

Tehnic da, pentru că e un Throwable, dar nu e recomandat: e o Error, nu o Exception, iar după ea starea programului poate fi instabilă. Mai bine previi cauza.

Care e diferența față de StackOverflowError?

StackOverflowError înseamnă că s-a umplut stiva de apeluri, de obicei din recursivitate fără sfârșit. OutOfMemoryError: Java heap space înseamnă că s-a umplut heap-ul, unde stau obiectele.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.