Node.js: FATAL ERROR: JavaScript heap out of memory — не хватило памяти
Node.js хранит данные программы в куче — области памяти с пределом. Программе понадобилось больше, и Node.js её остановил. На сервере так падает сборка сайта через npm run build или приложение, у которого растёт память.
Содержание 8
Как выглядит ошибка
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memoryИли так:
FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memoryПроцесс Node.js при этом завершается — сборка или приложение останавливаются. Обе строки значат одно: память кучи кончилась, а сборщик мусора не смог её освободить.
Если в журнале сервера вместо этого есть Out of memory: Killed process, программу остановило ядро Linux, потому что память кончилась у всего сервера, — это другая ошибка.
Шаг 1. Посмотрите, сколько памяти на сервере
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
free -hВ строке Mem колонка available — сколько памяти можно отдать программам. Подробнее — команда free.
Шаг 2. Поднимите предел кучи
Предел задаёт параметр --max-old-space-size, число — в мебибайтах. Для сборки его передают через переменную NODE_OPTIONS прямо в команде:
NODE_OPTIONS=--max-old-space-size=1536 npm run buildДокументация Node.js советует для машины с 2 ГиБ памяти значение 1536, чтобы осталась память для системы и других программ. Ставьте предел меньше, чем показала колонка available: если он больше свободной памяти, программу может остановить уже ядро.
Для приложения, запущенного службой systemd, добавьте строку в раздел [Service] файла службы (sudo nano /etc/systemd/system/myapp.service):
Environment=NODE_OPTIONS=--max-old-space-size=1536И перезапустите службу:
sudo systemctl daemon-reload
sudo systemctl restart myappЕсли приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.
Шаг 3. Если памяти на сервере мало
Сборке фронтенда — например, на React, Vue или Next.js — может не хватить памяти VPS с 1 ГиБ. Есть два выхода:
- Добавить файл подкачки — как создать swap. Сборка пойдёт медленнее, но сможет закончиться.
- Собирать проект на своём компьютере и загружать на сервер готовую папку — dist или build, смотря что создаёт ваша сборка.
Шаг 4. Если падает работающее приложение
Если ошибка приходит не при сборке, а через часы или дни работы приложения, его память растёт: данные копятся в массиве или объекте, кэш без ограничения размера. Поднятый предел только отодвинет падение. Посмотрите, сколько памяти занимает node, и повторите через время:
ps -o pid,rss,cmd -C nodeКолонка RSS — занятая память в килобайтах. Если число растёт без остановки, ищите в коде, где копятся данные.
Как проверить
Повторите сборку с новым пределом. Она должна закончиться без строки FATAL ERROR. Для службы проверьте, что переменная применилась:
systemctl show myapp -p EnvironmentВ ответе должна быть строка Environment=NODE_OPTIONS=--max-old-space-size=1536.
Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.
Источники
- Исходный код V8 в Node.js 22.22.1: heap.cc — причины Reached heap limit и Ineffective mark-compacts near heap limit.
- Исходный код Node.js 22.22.1: src/node_errors.cc — вид строки FATAL ERROR и текст Allocation failed - JavaScript heap out of memory.
- Документация Node.js 22: Command-line options — --max-old-space-size в мебибайтах, совет 1536 для 2 ГиБ, параметр разрешён в NODE_OPTIONS.
- Справка systemd.exec для Ubuntu 24.04 — строка Environment= в файле службы.
Сверено 22 октября 2026 года.
Что почитать дальше
- Out of memory: Killed processкогда память кончилась у сервера.
- Как создать swapфайл подкачки на Ubuntu.
- Команда freeсколько памяти свободно.
- Все ошибки Node.js и npmтаблица по тексту сообщения.