JavaScript Heap Out of Memory en GitHub Actions: solución
Última actualización:
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory significa que un proceso de Node.js agotó el límite de heap de V8 y se interrumpió. Es un fallo distinto al de que el kernel elimine el proceso (código de salida 137): aquí es Node quien se detiene, porque el límite que se le asignó es demasiado bajo para la carga de trabajo. Los bundlers, las compilaciones de TypeScript, ESLint y Jest en proyectos grandes suelen topar primero con este error. npm ERR! code ENOMEM es el caso relacionado en el que la propia máquina no puede asignar memoria.
El mensaje exacto
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
Tras el mensaje de V8, el paso normalmente termina con un código de salida distinto de cero, a menudo 134, que corresponde a SIGABRT.
Solución 1: aumentar el límite del heap, por debajo de la RAM del runner
El límite de heap predeterminado de Node depende de la versión de Node y de la memoria de la máquina, y las compilaciones grandes pueden superarlo. Defínalo con NODE_OPTIONS, en megabytes:
- run: npm run build
env:
NODE_OPTIONS: --max-old-space-size=6144
Mantenga el valor por debajo de la RAM del runner, dejando margen para el sistema operativo y otros procesos. Un runner Linux estándar de repositorios privados tiene mucha menos memoria que un portátil de desarrollo, por lo que un límite que funciona en local puede llevar la máquina al swap o provocar que el sistema la elimine por falta de memoria. Consulte las especificaciones de los runners de la máquina que utiliza.
Solución 2: definirlo solo para una herramienta, no para todo el job
NODE_OPTIONS se aplica a todos los procesos de Node del paso, incluido el gestor de paquetes. Para aumentar el límite solo para un comando:
- 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 .
Solución 3: usar menos memoria
- Desactive los source maps en las compilaciones de CI, o genérelos en un job separado.
- Ejecute la comprobación de tipos, el linter y el bundle como pasos o jobs independientes, para que sus heaps no se sumen en un mismo proceso.
- En Jest, limite los workers y reinicie los que pierdan memoria:
- run: npx jest --maxWorkers=2 --logHeapUsage
- En monorepos de TypeScript, use project references y compilaciones incrementales para que un solo proceso no cargue todo a la vez.
- Elimine del grafo de compilación las dependencias voluminosas que solo se necesitan en desarrollo.
Solución 4: npm ERR! code ENOMEM
Un ENOMEM durante npm ci o npm install significa que la máquina se quedó sin memoria al descomprimir o ejecutar los scripts de instalación. Libere memoria ejecutando menos pasos en paralelo, no iniciando servicios en segundo plano antes de la instalación y usando un runner con más memoria. Una causa habitual son los scripts postinstall que compilan módulos nativos.
Solución 5: añadir RAM
Si ha ajustado los límites y la compilación sigue necesitando más, asígnele una máquina más grande. Las opciones son un GitHub larger runner o un proveedor como compiler.dev, cuya máquina Linux predeterminada tiene 8 vCPU y 16 GB (consulte los precios). Cambiar de máquina implica modificar runs-on.
Cómo prevenirlo
- Registre el pico de memoria en CI y genere una alerta cuando supere aproximadamente el 75 % de la RAM del runner.
- Defina
--max-old-space-sizede forma explícita en lugar de depender de los valores predeterminados. - Vigile el tamaño del bundle y la memoria de los tests al actualizar dependencias.
- Mantenga un único proceso de Node pesado por paso.
Preguntas frecuentes
¿Cuál es el límite de heap predeterminado de Node.js?
Depende de la versión de Node y de la memoria del sistema, por lo que no existe una cifra única. Compruébelo con node -e "console.log(v8.getHeapStatistics().heap_size_limit / 1048576)" en el runner.
¿Es lo mismo que el código de salida 137?
No. El 137 significa que el sistema operativo eliminó el proceso. Este error es Node interrumpiéndose a sí mismo al alcanzar su propio límite de heap, y normalmente se soluciona aumentando --max-old-space-size.
¿Por qué funciona en local?
Su portátil tiene más memoria y Node elige un heap predeterminado mayor. Las máquinas de CI son más pequeñas y tienen recursos fijos.
¿Puedo definir el límite en package.json?
Sí, por ejemplo "build": "node --max-old-space-size=6144 node_modules/vite/bin/vite.js build". Definir NODE_OPTIONS en el workflow es más sencillo.
Relacionado
- Cache Service Responded With 429: Cómo solucionarloSolucione "Failed to restore: Cache service responded with 429" en GitHub Actions: demasiadas solicitudes de caché. Actualice actions/cache y restaure y guarde una vez.
- fatal: could not read Username for github.com: SoluciónSolucione "fatal: could not read Username for 'https://github.com'" en GitHub Actions: repos privados, submódulos y dependencias git necesitan un token.
- Archivo de flujo de trabajo no válido: cómo solucionar el error de sintaxis YAMLCorrija "Invalid workflow file" y "You have an error in your yaml syntax" en GitHub Actions: sangría, valor inesperado, expresiones erróneas, con actionlint.
- Permission Denied (publickey) en GitHub Actions: soluciónCorrija "git@github.com: Permission denied (publickey)" en GitHub Actions: añada una clave SSH o de despliegue, o use un token HTTPS en repos privados.