java.lang.OutOfMemoryError: Java heap space beheben

Ursache

Im Heap liegen unter anderem Welt- und Chunkdaten, Entities sowie Daten von Plugins und Mods. Steigt deren Bedarf bis zum gesetzten Maximum und kann die Garbage Collection nicht genug ungenutzte Objekte freigeben, bricht die nächste Speicheranforderung ab. Typische Auslöser sind mehr gleichzeitig geladene Chunks, hohe Sicht- oder Simulationsdistanzen, viele Entities, ein größeres Modpack oder eine Erweiterung, deren Speicherverbrauch über längere Laufzeit weiter anwächst.

Gilt für

Die Anleitung gilt für serverseitige Minecraft-Java-Prozesse, deren Log exakt die Signatur java.lang.OutOfMemoryError: Java heap space enthält, zum Beispiel Vanilla, Paper, Purpur, Spigot, Forge oder Fabric. Sie gilt nicht automatisch für einen abgestürzten Minecraft-Client, eine volle Metaspace-Region oder einen vom Betriebssystem ohne diese Java-Meldung beendeten Prozess.

Schritte

1. Bestätige zuerst die exakte Signatur in der Serverkonsole oder latest.log und notiere Zeitpunkt, Serverversion und die letzte Änderung davor. Prüfe, ob der Fehler beim Start, beim Erkunden neuer Chunks, bei vielen Spielern oder erst nach längerer Laufzeit auftrat. Eine ähnlich aussehende Meldung mit GC overhead limit exceeded oder Metaspace gehört zu einem anderen Fehlerbild.
2. Erstelle vor Änderungen ein Backup und starte den Server einmal sauber neu. Stelle anschließend möglichst dieselbe Last wieder her und beobachte, wann der Verbrauch erneut ansteigt. Halte Spielerzahl, geladene Welten, Sichtweite sowie kürzlich aktualisierte Plugins oder Mods fest. Ändere nicht gleichzeitig mehrere Ursachen, weil du sonst nicht erkennen kannst, welcher Schritt geholfen hat.
3. Reduziere vermeidbare Last schrittweise: setze view-distance und simulation-distance niedriger, begrenze dauerhaft aktive Chunkloader und auffällige Entity-Farmen und nimm testweise die zuletzt hinzugefügte Erweiterung zurück. Begann der Fehler direkt nach einem Modpack- oder Plugin-Update, teste zuerst die vorherige kompatible Version. Starte nach jeder zusammengehörigen Änderung neu und wiederhole denselben Belastungstest.
4. Reicht der Speicher bei normaler, gewünschter Last weiterhin nicht aus, ermittle den Bedarf mit dem Minecraft-RAM-Rechner und stelle im Kundenpanel passend mehr Arbeitsspeicher bereit. Bei game-serverhosting sind die JVM-Startparameter bereits auf den gebuchten Speicher abgestimmt; ändere Xmx nicht auf Verdacht. Plane Reserve für Spitzen beim Start, bei Backups und beim gleichzeitigen Laden neuer Chunks ein, ohne RAM pauschal zu überdimensionieren.
5. Tritt der Fehler trotz ausreichender Reserve erst nach Stunden oder Tagen erneut auf und wächst der Verbrauch bei vergleichbarer Last immer weiter, isoliere Plugins oder Mods einzeln. Mehr RAM kann ein Speicherleck nur verzögern. Bleibt die Ursache unklar, übermittle dem Support die exakte Signatur, Uhrzeit, Minecraft- und Loader-Version sowie die letzte Änderung; ein kompletter ungeprüfter Logdump mit Tokens oder Adressen ist dafür nicht nötig.

So prüfst du die Lösung

Der Fehler gilt als behoben, wenn der Server bis zur Meldung Done startet, unter derselben Spieler-, Chunk- und Modlast stabil bleibt und die exakte Java-Heap-Signatur nicht wiederkehrt. Beobachte nicht nur den leeren Start, sondern mindestens den zuvor auffälligen Ablauf. Steigt die Speichernutzung bei gleichbleibender Last erneut stetig bis an das Limit, war die zusätzliche Reserve nur ein Aufschub und die verursachende Erweiterung muss weiter eingegrenzt werden.

Wann diese Lösung nicht passt

GC overhead limit exceeded ist ein eigener Speicherdruck-Fall, Metaspace betrifft Klassenmetadaten und ein Linux- oder Container-OOM-Kill kann den Prozess ohne diese Java-Signatur beenden. Meldungen wie Can’t keep up oder ein Watchdog-Timeout weisen dagegen zunächst auf Tick- beziehungsweise CPU-Probleme hin. Allein eine hohe RAM-Anzeige ohne java.lang.OutOfMemoryError: Java heap space ist deshalb kein ausreichender Grund für ein Upgrade.