Гайды

Maximum call stack size exceeded — почему падает и как починить, даже без рекурсии

Иллюстрация: башня из коробок уходит за край кадра и начинает крениться

Приложение работало. Ты загрузил большой файл с данными — и в консоли красное: RangeError: Maximum call stack size exceeded. Гуглишь, и везде один ответ: «у тебя бесконечная рекурсия». Смотришь в код — никакой рекурсии там нет. Одна строчка Math.max(...prices).

Смотри, в чём дело: эта ошибка значит не «рекурсия», а «стопка вызовов переполнилась». Рекурсия — самый частый способ её переполнить, но не единственный. Разберём три настоящие причины — от частой к неожиданной.

Что значит эта ошибка

Каждый вызов функции кладётся в стек вызовов — стопку, где лежат все функции, которые начали работу и ещё не закончили. У стопки есть потолок. В Node.js 22 простая функция может вызвать сама себя примерно 12 тысяч раз — дальше падение. Мы проверили.

Упёрлась стопка в потолок — движок останавливает программу с этой ошибкой. В Python то же самое называется RecursionError, и потолок там около тысячи вызовов.

Главный инструмент поиска — стек-трейс под ошибкой. Посмотри на него до всяких правок.

Причина 1: функция вызывает сама себя без конца

Самая частая. Функция вызывает себя, та снова себя — и так, пока не кончится место.

Как проверить. В стек-трейсе одна и та же строка с одним и тем же именем функции повторяется десятки раз подряд. Это почти подпись.

Бывает явная рекурсия, у которой забыли условие выхода. А бывает случайная — такую часто пишет ИИ. Например, обёртка с тем же именем, что и оригинал:

async function fetch(url) {
  console.log("запрос:", url);
  return fetch(url); // вызывает не встроенный fetch, а саму себя
}

Своя функция fetch закрыла собой встроенную. Внутри имя fetch указывает уже на неё. Каждый вызов порождает следующий.

Как починить. Для явной рекурсии — проверь, что у неё есть «дно»: условие, при котором она возвращает результат и не вызывает себя. И что каждый шаг к этому дну приближается. Для случайной — переименуй обёртку: loggedFetch. Тогда внутри fetch снова будет встроенным.

Причина 2: сеттер или геттер обращается к самому себе

Хитрая, потому что на вид код безобидный:

class User {
  set name(value) {
    this.name = value.trim(); // снова вызывает этот же сеттер
  }
}

Сеттер — это функция, которая срабатывает при записи в поле. Внутри он пишет в this.name — и тем самым вызывает себя. Потом ещё раз. Мы проверили: падает ровно с этой ошибкой. С геттером, который читает сам себя, — та же история.

Как проверить. В стек-трейсе повторяется строка со словами set name или get name.

Как починить. Храни значение в поле с другим именем. Современный способ — приватное поле с решёткой:

class User {
  #name = "";
  set name(value) { this.#name = value.trim(); }
  get name() { return this.#name; }
}

Причина 3: огромный массив, разложенный на аргументы

Самая неожиданная. Никакой рекурсии нет вовсе:

const biggest = Math.max(...prices);
items.push(...newItems);

Три точки раскладывают массив на отдельные аргументы функции. А аргументы при вызове тоже кладутся на стек. Пока в массиве сотня элементов — всё отлично. Когда там сотни тысяч — место кончается. В Node.js 22 у нас Math.max(...) выдержал около 125 тысяч элементов и упал на большем. Точный порог зависит от браузера — поэтому на твоих тестовых данных всё работает, а на настоящих падает.

Как проверить. В стек-трейсе нет повторов — всего одна-две строки, и последняя указывает на строчку с тремя точками.

Как починить. Для максимума и минимума — обычный проход по массиву:

const biggest = prices.reduce((max, p) => (p > max ? p : max), -Infinity);

Для склейки массивов — items = items.concat(newItems) или цикл с push по одному.

Как искать быстро

Порядок действий, который работает почти всегда:

  1. Открой стек-трейс и найди первую строку из своего файла. Как читать такие сообщения, разобрано в статье как читать сообщение об ошибке.
  2. Посмотри, повторяется ли она. Повторяется — причина 1 или 2. Нет — ищи рядом три точки, причина 3.
  3. Не увеличивай лимит стека флагами. Это прячет баг, а не чинит его.

Если разбираться лень — отдай ИИ полный стек-трейс и строку, на которую он указывает. Пошаговый подход описан в статье как отлаживать код с ИИ. Фраза «падает Maximum call stack, вот трейс, повторяется строка 42» даёт модели всё нужное.

Это то же самое, что «Maximum update depth exceeded» в React?

Нет, но родственники. Та ошибка — защита React от бесконечного цикла обновлений: компонент меняет состояние при каждой отрисовке. Стек там не переполняется, React останавливает цикл сам.

Почему у меня работает, а у пользователя падает?

Потолок стека разный в разных браузерах и зависит от того, сколько места съедает каждый вызов. Код на грани лимита может работать в Chrome и падать в Safari. Чинить надо причину, а не надеяться на запас.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →