Сборка Next.js в GitHub Actions медленная или падает от нехватки памяти: кэш, память, размер раннера
Сборка Next.js в GitHub Actions медленная по одной причине и падает от нехватки памяти по другой. Она медленная, когда .next/cache не переносится в следующий запуск: Next.js переиспользует этот кэш между сборками, задание на раннере GitHub начинается на новой ВМ, и без шага кэширования каждая сборка «холодная» (лог пишет No Cache Detected). Ей не хватает памяти, потому что у ubuntu-latest в приватном репозитории 8 ГБ, а компиляция webpack большого приложения, проверка типов и source maps могут превысить это. Первое исправляет actions/cache на .next/cache. Для второго сначала идут настройки памяти Next.js (experimental.webpackMemoryOptimizations, без production source maps), а затем — машина с бо́льшим объёмом памяти: 16 ГБ или 32 ГБ.
Skipbox даёт сборке эту память по фиксированной цене: 16 ГБ и 8 vCPU на runs-on: skipbox-8x16 за $79 в месяц, 32 ГБ и 16 vCPU на skipbox-16x32 за $149. На вашей выделенной машине .next/cache остаётся для следующей сборки, кэши пакетов остаются на диске, а то, что сохраняет actions/cache, читается локально, и минуты не ограничены.
Медленно: .next/cache начинается пустым
Из руководства Next.js по кэшированию сборки в CI (на английском): Next.js сохраняет в .next/cache кэш, общий для сборок, а CI, который не сохраняет его между сборками, показывает ошибку No Cache Detected. Его шаг для GitHub Actions:
- uses: actions/cache@v4
with:
path: |
~/.npm
${{ github.workspace }}/.next/cache
key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
restore-keys: |
${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
Ключ меняется при каждом изменении исходников, поэтому каждый запуск сохраняет новую запись, внутри 10 ГБ GitHub на репозиторий. В Turborepo исключите .next/cache из outputs задачи ("!.next/cache/**"), как это делает руководство Turborepo по GitHub Actions.
Нехватка памяти: две разные ошибки
| В логе | Что кончилось | Что делать |
|---|---|---|
JavaScript heap out of memory | Собственный лимит heap у Node; у машины память ещё была | Поднять его: NODE_OPTIONS=--max-old-space-size=6144, ниже объёма памяти машины |
Process completed with exit code 137 | Память машины: Linux убил процесс | Тратить меньше памяти или взять машину с бо́льшим объёмом |
Если поднять heap выше памяти машины, первая ошибка превращается во вторую.
Тратьте меньше памяти: собственные настройки Next.js
Из руководства Next.js по потреблению памяти:
experimental.webpackMemoryOptimizations: true(v15.0.0 и новее) снижает пиковое потребление памяти webpack ценой чуть более долгой компиляции.- Webpack build worker выполняет компиляцию в отдельном воркере Node, что снижает память. Начиная с v14.1.0 он включён по умолчанию, если у вас нет своей конфигурации webpack; если есть — поставьте
experimental.webpackBuildWorker: true. - Source maps выключены:
productionBrowserSourceMaps: falseиexperimental.serverSourceMaps: false. Если память кончается на «Generating static pages», ещё иenablePrerenderSourceMaps: false. - Измеряйте:
next build --experimental-debug-memory-usage(v14.2.0 и новее) выводит использование heap по ходу сборки и снимает heap snapshots у самого лимита. - Проверка типов:
typescript.ignoreBuildErrors: trueпропускает проверку типов и её память — и пропускает ошибки типов в сборку. Next.js не советует так делать, если типы не проверяет другой шаг.
Возьмите машину с бо́льшим объёмом памяти
| Раннер | CPU и память | Кому доступен |
|---|---|---|
GitHub ubuntu-latest, приватный репозиторий | 2 CPU, 8 ГБ | Всем |
GitHub ubuntu-latest, публичный репозиторий | 4 CPU, 16 ГБ | Публичным репозиториям |
| Более крупный раннер GitHub, 4 или 8 ядер | 16 ГБ или 32 ГБ | Организациям на GitHub Team и Enterprise Cloud, поминутно (более крупные раннеры) |
Skipbox skipbox-8x16 | 8 vCPU, 16 ГБ | Организациям и личным аккаунтам, $79 в месяц |
Skipbox skipbox-16x32 | 16 vCPU, 32 ГБ | Организациям и личным аккаунтам, $149 в месяц |
При 20 000 минут в месяц 8-ядерный раннер GitHub стоит $422, а Skipbox M — $79; на 16 ядрах — $822 против $149 за L. Суммы GitHub — после вычета использования, включённого в GitHub Team.
Что Skipbox делает для сборки Next.js
Каждый тариф — это выделенная машина вашего аккаунта, которая сохраняется между заданиями:
- Память, которая нужна сборке, по метке: 16 ГБ на M, 32 ГБ на L. Настройте heap под неё, например
--max-old-space-size=12288на M. - Кэши пакетов остаются на диске:
~/.npm, хранилище pnpm,~/.cacheкаждого инструмента и версии Node, которые поставилsetup-node.npm ciчитает их, а не registry. .next/cacheостаётся для следующего задания. Машина сохраняет ваш checkout между заданиями, а в нём.next/cache, на любой глубине монорепозитория (apps/web/.next/cache). Следующийnext buildначинает с него, без шага кэширования и безNo Cache Detected. Остальное содержимое.nextи другие неотслеживаемые файлы checkout очищаются после каждого задания.- Восстановление
actions/cacheчитает машину. То, что он сохраняет, остаётся рядом с машиной, места больше, чем 10 ГБ GitHub на репозиторий, а восстановление — это локальное чтение. Шаг для.next/cacheоставьте для заданий на новой ВМ; на выделенной машине восстановление не трогает сохранённый кэш. - Больше ядер по фиксированной цене. Их используют компиляция и генерация статических страниц, а минуты не ограничены.
| Метка | Машина | Тариф |
|---|---|---|
skipbox | 4 vCPU · 16 ГБ | S, $39 в месяц |
skipbox-8x16 | 8 vCPU · 16 ГБ | M, $79 в месяц |
skipbox-16x32 | 16 vCPU · 32 ГБ | L, $149 в месяц |
Переход — это одна строка
jobs:
build:
runs-on: skipbox-8x16 # was ubuntu-latest
env:
NODE_OPTIONS: --max-old-space-size=12288
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- uses: actions/cache@v4
with:
path: ${{ github.workspace }}/.next/cache
key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
restore-keys: |
${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
- run: npm ci
- run: npx next build
skipbox-8x16 выполняется на тарифе M; пробный период выполняет runs-on: skipbox.
- Войдите в Skipbox через GitHub.
- Установите GitHub App Skipbox и выберите репозитории.
- Измените
runs-onи сделайте push.
Безопасность
- Машина принадлежит только вашему аккаунту. Задания других компаний на ней не выполняются.
- После каждого задания стираются учётные данные раннера, процессы и контейнеры, а в сохранённом checkout — учётные данные git и неотслеживаемые файлы, кроме кэшей сборки вроде
.next/cache. Режим «Чистая ВМ для каждого задания» вместо этого даёт каждому заданию новую машину. - Код от людей без прав на запись (например, pull request из форков) выполняется на новой ВМ, которая читает ваши кэши, но не может их изменить.
Подробности — в разделе «Как изолированы задания».
Попробуйте на сборке Next.js
Пробный период бесплатный и без карты: 7 дней или 3 000 мин работы заданий — что закончится раньше. Он выполняет runs-on: skipbox с 16 ГБ — в 2× больше памяти, чем у ubuntu-latest в приватном репозитории: попробуйте там кэш и память, а сборку, которой нужно больше, перенесите на тариф L (skipbox-16x32, 32 ГБ).
Вопросы и ответы
Почему next build медленный в GitHub Actions?
Обычно потому, что .next/cache начинается пустым. Next.js сохраняет кэш сборки в .next/cache и переиспользует его в следующей сборке, но задание на раннере GitHub — это новая ВМ, поэтому без шага, который переносит .next/cache, каждая сборка «холодная», и лог предупреждает No Cache Detected. Добавьте actions/cache для .next/cache с ключом по lock-файлу и исходникам. Остальное время — установка и компиляция на 2 CPU.
Какой размер раннера нужен сборке Next.js в GitHub Actions?
Достаточно памяти для пика сборки. У ubuntu-latest в приватном репозитории 2 CPU и 8 ГБ, а сборка webpack большого приложения Next.js, проверка типов и source maps могут превысить это. У более крупных раннеров GitHub 16 ГБ на 4 ядрах и 32 ГБ на 8, только на GitHub Team или Enterprise Cloud, поминутно. Skipbox даёт 16 ГБ с 8 vCPU на runs-on: skipbox-8x16 за $79 в месяц и 32 ГБ с 16 vCPU на skipbox-16x32 за $149.
Как исправить JavaScript heap out of memory в сборке Next.js в GitHub Actions?
Эта ошибка — собственный лимит heap у Node, а не память машины. Поднимите его через NODE_OPTIONS=--max-old-space-size=<MiB>, ниже объёма памяти машины. Если после этого задание заканчивается кодом выхода 137, кончилась память самой машины: сократите память сборки (experimental.webpackMemoryOptimizations, без production source maps) или выполняйте её на машине с бо́льшим объёмом памяти.
Как сократить потребление памяти сборкой Next.js?
Из руководства Next.js по памяти: попробуйте experimental.webpackMemoryOptimizations (v15 и новее), оставьте включённым webpack build worker (по умолчанию без своей конфигурации webpack начиная с v14.1.0), выключите productionBrowserSourceMaps и experimental.serverSourceMaps и измеряйте через next build --experimental-debug-memory-usage. Пропуск проверки типов через typescript.ignoreBuildErrors экономит память, но пропускает ошибки типов, поэтому делайте так, только если типы проверяет другое задание CI.
Хранит ли Skipbox .next/cache между заданиями?
Да. Ваша выделенная машина сохраняет checkout между заданиями, а в нём и .next/cache, где бы его ни создал Next.js (в монорепозитории — apps/web/.next/cache), поэтому следующий next build начинает с кэша предыдущего без шага кэширования. Остальное содержимое .next и другие неотслеживаемые файлы checkout очищаются после каждого задания. Кэш npm или pnpm, версии Node, которые поставил setup-node, и слои Docker тоже остаются на диске. Шаг actions/cache для .next/cache можно оставить: задание на новой ВМ, например pull request из форка, восстанавливает кэш из него, а на выделенной машине восстановление не трогает сохранённый кэш.
Сколько стоит попробовать?
Ничего. Пробный период — 7 дней или 3 000 мин работы заданий, что закончится раньше, без карты, на 4 vCPU и 16 ГБ: в 2× больше, чем 8 ГБ у ubuntu-latest в приватном репозитории, и столько же, сколько у 4-ядерного более крупного раннера GitHub. Попробуйте там кэширование и память; для сборки, которой нужно больше, выберите тариф L и поменяйте метку на skipbox-16x32 (32 ГБ).
Обновлено 19 ноября 2026 г.