# Сборка Next.js в GitHub Actions медленная или падает от нехватки памяти: кэш, память, размер раннера

> Сборка Next.js в GitHub Actions медленная, когда .next/cache не переносится в следующий запуск, и падает от нехватки памяти на 8 ГБ ubuntu-latest в приватном репозитории, когда webpack, проверка типов и source maps складываются. Что кэшировать, какие настройки Next.js сокращают память и какой нужен раннер: 16 ГБ за $79 в месяц или 32 ГБ за $149 в Skipbox, где .next/cache сохраняется между заданиями, а минуты без ограничений.

Сборка 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` остаётся на вашей выделенной машине: следующая сборка переиспользует прошлую компиляцию без шага кэширования
- 16 ГБ за $79 в месяц или 32 ГБ за $149 против 8 ГБ у `ubuntu-latest` в приватном репозитории
- Кэши пакетов остаются на вашей машине, а восстановление кэша читает её диск, а не скачивает

**GitHub Actions по фиксированной цене, минуты без ограничений** Skipbox выполняет задания GitHub Actions на вашей собственной выделенной машине: $39 в месяц, сколько бы минут вы ни использовали. Слои Docker и кэши зависимостей сохраняются между заданиями, поэтому следующее задание запускается сразу.

Раннер на 4 vCPU, 20 000 минут в месяц: GitHub $222 → Skipbox $39. Вы экономите $183 каждый месяц.

Достаточно изменить одну строку: `runs-on: skipbox`.

[Попробовать бесплатно 7 дн.](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-ru)

## Медленно: .next/cache начинается пустым

Из [руководства Next.js по кэшированию сборки в CI](https://nextjs.org/docs/app/guides/ci-build-caching) (на английском): Next.js сохраняет в `.next/cache` кэш, общий для сборок, а CI, который не сохраняет его между сборками, показывает ошибку `No Cache Detected`. Его шаг для GitHub Actions:

```yaml
- 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](https://turborepo.dev/docs/guides/ci-vendors/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 по потреблению памяти](https://nextjs.org/docs/app/guides/memory-usage):

- **`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, поминутно ([более крупные раннеры](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| 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 в месяц |

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

```yaml
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 из форков) выполняется на новой ВМ, которая читает ваши кэши, но не может их изменить.

Подробности — в разделе [«Как изолированы задания»](https://docs.skipbox.dev/ru/isolation).

## Попробуйте на сборке 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 ГБ).

Обновлено 2026-11-19 · https://skipbox.dev/ru/guides/nextjs-build-slow-out-of-memory-github-actions
