Когда импорт превращается в zip-бомбу: регрессии бандла в Next.js
AI-assisted кодинг, он же вайб-кодинг, — это уже часть жизни, но рассказывать очередную историю про «AI slop» мне не хочется. Хотя иногда из этого выходит что-то интересное, и у нас как раз такой случай.
В одном PR были изменения, которые на первый взгляд выглядели хорошо. На ревью никто ничего подозрительного не заметил, а вот одна из наших проверок на PR — заметила. Страница могла вырасти на 153 KiB, хотя нового кода там было всего 7 KiB. В этой статье расскажу, как мы реализовали проверку размера бандла и с какими проблемами столкнулись.
Как это принято делать
В прошлой статье мы сделали несколько серьёзных улучшений. Честно говоря, мы постоянно что-то ускоряем, где-то по мелочи, где-то по-крупному, и конца этому не видно. А если ты что-то улучшил, очень хочется, чтобы так и оставалось. Но время от времени мы замечали на дашбордах деградации.
Покопавшись пару раз, мы выяснили, что все деградации были связаны с ростом бандла. Решили за ним следить и посмотреть, как это делают другие.

Обычно это делают вручную или берут nextjs-bundle-analysis или что-то похожее. Нам он не подошёл: он читает только роуты Pages Router, а мы как раз планировали переезд на App Router. Подходящего инструмента для нас просто не было.
Обходной путь
Начнём с плохих новостей: Next.js убрал из вывода сборки размеры, статистику first-load JS и манифесты. По их словам, эти цифры не показывали реальные размеры ни для Webpack, ни для Turbopack. Подробнее об этом написали в Catchmetrics.
Что у нас оставалось: @next/bundle-analyzer, который работает только со сборкой на webpack, и next experimental-analyze, который годится только для того, чтобы смотреть глазами. Построить пайплайн на этих инструментах было невозможно.
Как только я это понял, решил посмотреть, какие артефакты остаются после билда. Несколько grep’ов и cat’ов, и — БУМ, нашёлся route-bundle-stats.json. Роуты, чанки, все данные, которые были нужны. Сжатых размеров там нет, и файл не задокументирован, но ничего страшного, мы рискнули.
Я написал небольшую CLI-утилиту: бюджет, сжатие, сравнение отчётов — всё, что нам было нужно. Никакого rocket science, просто инструмент, который решает наши задачи.
Расскажу в двух словах, как он устроен.
Внутри всего две команды:
measureразбирает артефакты билда, получает список чанков и сжимает их;diffпросто сравнивает два результата замеров, показывает разницу, подсвечивает роуты, которые упёрлись в пороги, и при необходимости падает с ошибкой.
Если что-то идёт не так, например чанка нет или формат поменялся, утилита об этом скажет и упадёт с ошибкой.
С чем сравнивать
Первая версия была максимально простой:
- Запускаем
route-bundle-sizeв каждом превью и храним артефакты в GitHub; - В фича-PR запускаем сравнение и собираем отчёт.
Но быстро выяснилось, что сравниваем мы не с тем, с чем нужно.
Проблемных мест было два:
- В main артефакт загружался только после успешного прогона e2e;
- PR не всегда ребейзнут на свежий main.

На практике e2e иногда краснеют, а разработчики не всегда подтягивают main в свою ветку.
Представьте: main ушёл вперёд на несколько коммитов, и один из них уменьшил бандл. У вашей ветки падает проверка, хотя вы ничего плохого не сделали — просто этих коммитов у вас в ветке нет.
Особенно сложно это объяснить в новом AI-мире, где кодить пробуют все подряд: делают прототипы, реализуют то, что пришло в голову. Но опыта у них чуть меньше, чем у разработчиков, и такие падения их сильно расстраивают.
По цифрам: примерно половина падений v1 были ложными. Ветки, синхронные с main, падали в 5,7% проверок, а ветки, отставшие на 20+ коммитов, — в 43%.
Поэтому мы перешли на схему с merge-base. Теперь это три джобы:
- Берём артефакты текущего билда;
- Берём артефакты коммита merge-base. Тут два варианта: достать их из кеша экшена или сбилдить заново;
- Запускаем CLI
route-bundle-size→ сравниваем артефакты → обновляем job summary.
Публичный GitHub Action делает то же самое в одной джобе, но всегда пересобирает merge-base и не использует кеш.

А теперь к самому интересному.
Кейс
Так что же случилось?
У нас был PR с довольно очевидными изменениями, и бо́льшую часть из них написал агент. Пока делал продуктовую фичу, агент вынес новый модуль и экспортировал его через barrel — у нас FSD-архитектура, и это одно из её правил. В итоге в 4 файлах появился такой импорт:
import { getCanvasImagesSource } from '@/shared/model/canvas'
Тем временем в main смержили другой PR — с редизайном страницы стиля. Подтянули main в наш PR и получили вот это:

Просто так совпало. Ни один из этих PR ничего плохого не сделал, по отдельности оба изменения были вполне уместны. Но вместе — БУМ.
Дальше мы попросили агента прочитать отчёт и найти проблему. Честно говоря, с такой отладкой агенты справляются отлично.
Агент разобрал бандлы, нашёл, что barrel тянет код движка на страницы стилей, и поправил всего лишь 4 импорта. Type-only импорты так и остались через barrel: TypeScript всё равно вырезает их при сборке. На ревью мы вынесли модуль в отдельный слайс, так что правило FSD соблюдено, а бандл остался лёгким:
- import { getCanvasImagesSource } from '@/shared/model/canvas'
+ import { getCanvasImagesSource } from '@/shared/model/canvasImages'
Вот как менялся размер бандла на каждом шаге:

Так в чём была проблема? Source maps показали, что одни и те же модули были общими для нескольких точек входа, и часть из них оказалась в бандле дважды (думаю, так работает разрешение циклических зависимостей).

В итоге без проверки размера бандла наше приложение в сумме выросло бы на 200 KiB. Мы бы, конечно, заметили это по алертам, но какое-то время это жило бы в продакшене.
Хорошие новости
Это была одна сторона проверки размера бандла. Теперь о второй.
Проверка не только ловит плохие изменения, но и показывает хорошие.
Есть хороший пример: какое-то время мы жили с двумя разными версиями UI. Нормально разделить их было невозможно, и, конечно, это приводило к деградациям.
После долгой работы и нескольких экспериментов мы переехали на новую версию, а потом решили удалить старые части UI и посмотреть, что изменится. Мы удалили 220 файлов и 19 354 строки кода: /projects потерял четверть своего first-load JS (−26%), а всего полегчали 22 роута.

Теперь у нас есть убедительное доказательство того, что наша работа была не зря и что рефакторинг влияет на пользовательский опыт. Не только фичи делают его лучше.
Пакет
В итоге мы решили выложить нашу маленькую CLI-утилиту для сравнения в open source.
Где она теперь живёт:
Что это такое? Это наша внутренняя CLI-утилита, которой мы пользовались полгода и наконец решили ею поделиться.
Конечно, есть нюансы: формат не задокументирован в Next.js; считается только first-load JS (уверен, что сейчас это важнее всего, но кому-то позанудней меня этого может не хватить!). Отдельные бюджеты для роутов появились в 0.2.0 (budget.overrides, budget.maxSize).
Спасибо, что дочитали! Заглядывайте, смотрите, заводите issues, тестируйте. Надеюсь, будет полезно!
Как мы мерили: логи CI того времени уже удалены по сроку хранения, поэтому все цифры в кейсах пересобраны локально на тех же коммитах с route-bundle-size@0.1.0. Доля ложных падений v1 — статистическая оценка по API GitHub, потому что логи v1 удалены.