JavaScript Heap Out of Memory in GitHub Actions: Beheben
Zuletzt aktualisiert am
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory bedeutet, dass ein Node.js-Prozess sein V8-Heap-Limit ausgeschöpft hat und abgebrochen wurde. Das ist ein anderer Fehler als das Beenden des Prozesses durch den Kernel (Exit-Code 137): Hier stoppt Node sich selbst, weil das vorgegebene Limit für die Arbeit zu klein ist. Bundler, TypeScript-Kompilierungen, ESLint und Jest stoßen bei großen Projekten als Erstes darauf. npm ERR! code ENOMEM ist der verwandte Fall, in dem der Rechner selbst keinen Speicher mehr zuweisen kann.
Die genaue Meldung
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
<--- Last few GCs --->
Aborted (core dumped)
npm ERR! code ENOMEM
npm ERR! errno ENOMEM
npm ERR! Cannot allocate memory
Nach der V8-Meldung endet der Schritt meist mit einem Exit-Code ungleich null, häufig 134, also SIGABRT.
Lösung 1: Heap-Limit anheben, unterhalb des RAM des Runners
Das Standard-Heap-Limit von Node hängt von der Node-Version und dem Speicher des Rechners ab, und große Builds können es überschreiten. Setzen Sie es mit NODE_OPTIONS in Megabyte:
- run: npm run build
env:
NODE_OPTIONS: --max-old-space-size=6144
Halten Sie die Zahl unterhalb des RAM des Runners und lassen Sie Platz für das Betriebssystem und andere Prozesse. Ein Standard-Linux-Runner für private Repositories hat deutlich weniger Speicher als ein Entwicklerlaptop, sodass ein lokal funktionierendes Limit den Rechner in den Swap treiben oder zu einem Out-of-Memory-Abbruch führen kann. Prüfen Sie die Runner-Spezifikationen für die von Ihnen genutzte Maschine.
Lösung 2: Nur für ein Tool setzen, nicht für den gesamten Job
NODE_OPTIONS gilt für jeden Node-Prozess im Schritt, einschließlich des Paketmanagers. Um das Limit nur für einen einzelnen Befehl anzuheben:
- run: node --max-old-space-size=6144 ./node_modules/.bin/tsc -p tsconfig.json
- run: node --max-old-space-size=4096 ./node_modules/.bin/eslint .
Lösung 3: Weniger Speicher verbrauchen
- Deaktivieren Sie Source Maps in CI-Builds oder erzeugen Sie sie in einem separaten Job.
- Führen Sie Typprüfung, Linting und Bundling als getrennte Schritte oder Jobs aus, damit sich ihre Heaps nicht in einem Prozess summieren.
- Begrenzen Sie für Jest die Worker und starten Sie undichte neu:
- run: npx jest --maxWorkers=2 --logHeapUsage
- Verwenden Sie für TypeScript-Monorepos Project References und inkrementelle Builds, damit nicht ein Prozess alles auf einmal lädt.
- Entfernen Sie große Abhängigkeiten, die nur in der Entwicklung benötigt werden, aus dem Build-Graphen.
Lösung 4: npm ERR! code ENOMEM
ENOMEM bei npm ci oder npm install bedeutet, dass dem Rechner beim Entpacken oder Ausführen von Install-Skripten der Speicher ausgegangen ist. Geben Sie Speicher frei, indem Sie weniger Schritte parallel ausführen, vor der Installation keine Dienste im Hintergrund starten und einen Runner mit mehr Speicher verwenden. Postinstall-Skripte, die native Module kompilieren, sind eine häufige Ursache.
Lösung 5: Mehr RAM bereitstellen
Wenn Sie die Limits optimiert haben und der Build trotzdem mehr benötigt, geben Sie ihm eine größere Maschine. Möglich sind ein größerer GitHub-Runner oder ein Anbieter wie compiler.dev, dessen Standard-Linux-Maschine 8 vCPU mit 16 GB hat (siehe Preise). Der Wechsel erfolgt durch eine Änderung von runs-on.
So verhindern Sie den Fehler
- Erfassen Sie den Spitzenspeicherbedarf in der CI und lösen Sie einen Alarm aus, wenn er etwa 75 % des RAM des Runners überschreitet.
- Setzen Sie
--max-old-space-sizeexplizit, statt sich auf Standardwerte zu verlassen. - Achten Sie beim Aktualisieren von Abhängigkeiten auf die Bundle-Größe und den Speicherbedarf der Tests.
- Behalten Sie pro Schritt einen rechenintensiven Node-Prozess bei.
FAQ
Wie hoch ist das Standard-Heap-Limit von Node.js?
Das hängt von der Node-Version und dem Systemspeicher ab, es gibt also keine einheitliche Zahl. Prüfen Sie es auf dem Runner mit node -e "console.log(v8.getHeapStatistics().heap_size_limit / 1048576)".
Ist das dasselbe wie Exit-Code 137?
Nein. 137 bedeutet, dass das Betriebssystem den Prozess beendet hat. Dieser Fehler ist Node, das sich selbst abbricht, wenn das eigene Heap-Limit erreicht ist, und er wird meist durch Anheben von --max-old-space-size behoben.
Warum funktioniert es lokal?
Ihr Laptop hat mehr Speicher, und Node wählt dort einen größeren Standard-Heap. CI-Maschinen sind kleiner und fest dimensioniert.
Kann ich das Limit in package.json setzen?
Ja, zum Beispiel "build": "node --max-old-space-size=6144 node_modules/vite/bin/vite.js build". Einfacher ist es, NODE_OPTIONS im Workflow zu setzen.
Verwandt
- Cache Service Responded With 429: So beheben Sie den FehlerFix "Failed to restore: Cache service responded with 429" in GitHub Actions: zu viele Cache-Anfragen. actions/cache aktualisieren, einmal wiederherstellen, einmal speichern.
- fatal: could not read Username for github.com: BehebenBehebe "fatal: could not read Username for 'https://github.com'" in GitHub Actions: Private Repos, Submodules und Git-Abhängigkeiten benötigen einen Token.
- Ungültige Workflow-Datei: YAML-Syntaxfehler beheben"Ungültige Workflow-Datei" und "Fehler in der YAML-Syntax" in GitHub Actions beheben: Einrückung, unerwarteter Wert, fehlerhafte Ausdrücke, mit actionlint.
- Permission Denied (publickey) in GitHub Actions: BehebenBehebt "git@github.com: Permission denied (publickey)" in GitHub Actions: SSH-Schlüssel oder Deploy-Key hinzufügen oder für private Repos auf HTTPS-Token wechseln.