Поиск
Ошибки

Node.js: FATAL ERROR: JavaScript heap out of memory — не хватило памяти

Node.js хранит данные программы в куче — области памяти с пределом. Программе понадобилось больше, и Node.js её остановил. На сервере так падает сборка сайта через npm run build или приложение, у которого растёт память.

≈ 4 мин чтения4 шага
Содержание 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.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше