Skipbox

Сборка 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.

Нехватка памяти: две разные ошибки

Если поднять 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 не советует так делать, если типы не проверяет другой шаг.

Возьмите машину с бо́льшим объёмом памяти

При 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 оставьте для заданий на новой ВМ; на выделенной машине восстановление не трогает сохранённый кэш.
  • Больше ядер по фиксированной цене. Их используют компиляция и генерация статических страниц, а минуты не ограничены.

Переход — это одна строка

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.

  1. Войдите в Skipbox через GitHub.
  2. Установите GitHub App Skipbox и выберите репозитории.
  3. Измените 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 г.

Более быстрый CI/CD с всегда «тёплым» кэшем

Ваш «тёплый» раннер по фиксированной цене

Хостинг наш. Вы меняете одну строку. 1/12 стоимости GitHub при полной загрузке. Цена фиксированная — гоняйте CI хоть весь день. В 7× больше места под кэш, чем у GitHub.

  • Без карты
  • Вход через GitHub
  • Отмена в любой момент