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. Нет — ищи рядом три точки, причина 3.
- Не увеличивай лимит стека флагами. Это прячет баг, а не чинит его.
Если разбираться лень — отдай ИИ полный стек-трейс и строку, на которую он указывает. Пошаговый подход описан в статье как отлаживать код с ИИ. Фраза «падает Maximum call stack, вот трейс, повторяется строка 42» даёт модели всё нужное.
Это то же самое, что «Maximum update depth exceeded» в React?
Нет, но родственники. Та ошибка — защита React от бесконечного цикла обновлений: компонент меняет состояние при каждой отрисовке. Стек там не переполняется, React останавливает цикл сам.
Почему у меня работает, а у пользователя падает?
Потолок стека разный в разных браузерах и зависит от того, сколько места съедает каждый вызов. Код на грани лимита может работать в Chrome и падать в Safari. Чинить надо причину, а не надеяться на запас.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





