# Компилацията на Next.js е бавна или ѝ свършва паметта в GitHub Actions: кеш, памет, размер на рънъра

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

Компилацията на Next.js в GitHub Actions е бавна по една причина и ѝ свършва паметта по друга. Бавна е, когато `.next/cache` не се пренася към следващото изпълнение: Next.js използва този кеш отново между компилациите, задача, хоствана от GitHub, започва на нова VM и без стъпка за кеша всяка компилация е студена (логът казва `No Cache Detected`). Паметта ѝ свършва, защото `ubuntu-latest` в частно хранилище има 8 GB, а компилирането с webpack, проверката на типовете и source maps на голямо приложение могат да надхвърлят това. Първото се оправя с `actions/cache` за `.next/cache`. За второто първо идват настройките на Next.js за паметта (`experimental.webpackMemoryOptimizations`, без source maps в production); после машина с повече памет: 16 GB или 32 GB.

Skipbox дава на компилацията тази памет на фиксирана цена: 16 GB и 8 vCPU с `runs-on: skipbox-8x16` за $79 на месец, 32 GB и 16 vCPU с `skipbox-16x32` за $149. На отделната ви машина `.next/cache` остава за следващата компилация, кешовете на пакетите остават на диска, а записаното от `actions/cache` се чете локално, с неограничени минути.

- `.next/cache` остава на отделната ви машина: следващата компилация използва отново предишното компилиране, без стъпка за кеша
- 16 GB за $79 на месец или 32 GB за $149, срещу 8 GB на частен `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-bg)

## Бавна: .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-те GB на хранилище в 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, срещу малко по-дълго компилиране.
- **Build worker-ът на webpack** изпълнява компилирането в отделен Node worker, което намалява паметта. Той е включен по подразбиране от 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 предупреждава срещу това, освен ако друга стъпка не проверява типовете.

## Използвайте машина с повече памет

| Рънър | Процесор и памет | Кой може да го използва |
|---|---|---|
| GitHub `ubuntu-latest`, частно хранилище | 2 CPU, 8 GB | Всички |
| GitHub `ubuntu-latest`, публично хранилище | 4 CPU, 16 GB | Публични хранилища |
| По-голям рънър на GitHub, 4 или 8 ядра | 16 GB или 32 GB | Организации в GitHub Team и Enterprise Cloud, на минута ([по-големи рънъри](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | Организации и лични профили, $79 на месец |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | Организации и лични профили, $149 на месец |

При 20 000 минути на месец рънърът на GitHub с 8 ядра е $422, а Skipbox M е $79; при 16 ядра – $822 срещу $149 за L. Цифрите за GitHub са след включеното в GitHub Team използване.

## Какво прави Skipbox за компилация на Next.js

Всеки план идва с отделна машина за профила ви, пазена между задачите:

- **Паметта, от която се нуждае компилацията**, чрез етикета: 16 GB в M, 32 GB в L. Задайте heap според нея, например `--max-old-space-size=12288` в M.
- **Кешовете на пакетите остават на диска:** `~/.npm`, хранилището на pnpm, `~/.cache` на всеки инструмент и версиите на Node, инсталирани от `setup-node`. `npm ci` чете от тях вместо от регистъра.
- **`.next/cache` остава за следващата задача.** Машината пази работното ви копие между задачите, а с него и `.next/cache`, на каквато и дълбочина да го слага monorepo (`apps/web/.next/cache`). Следващото `next build` започва от него, без стъпка за кеша и без `No Cache Detected`. Останалото от `.next` и другите непроследени файлове в работното копие се почистват след всяка задача.
- **Възстановяванията от `actions/cache` четат машината.** Записаното от тях остава до машината, с повече място от 10-те GB на хранилище в GitHub, а възстановяването е локално четене. Запазете стъпката за `.next/cache` за задачите, които се изпълняват на нова VM; на отделната ви машина възстановяването оставя пазения кеш както е.
- **Повече ядра на фиксирана цена.** Компилирането и генерирането на статичните страници ги използват, а минутите са неограничени.

| Етикет | Машина | План |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 на месец |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 на месец |
| `skipbox-16x32` | 16 vCPU · 32 GB | 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. Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
3. Сменете `runs-on` и направете push.

## Сигурност

- Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
- След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват, както и идентификационните данни на git в пазеното работно копие и непроследените му файлове, освен кешовете на компилацията като `.next/cache`. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина.
- Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.

Подробностите са в [как са изолирани задачите](https://docs.skipbox.dev/bg/isolation).

## Изпробвайте го с компилацията на Next.js

Пробният период е безплатен за 7 дни или 3000 минути на задачи, което настъпи първо, без карта. Той изпълнява `runs-on: skipbox` с 16 GB, 2× паметта на `ubuntu-latest` в частно хранилище: изпробвайте кеша и паметта там и преместете компилация, която се нуждае от повече, на план L (`skipbox-16x32`, 32 GB).

## Често задавани въпроси

### Защо next build е бавен в GitHub Actions?

Обикновено защото .next/cache започва празен. Next.js записва кеш на компилацията в .next/cache и го използва отново при следващата компилация, но задача, хоствана от GitHub, е нова VM, така че без стъпка, която пренася .next/cache, всяка компилация е студена, а логът предупреждава No Cache Detected. Добавете actions/cache за .next/cache с ключ по lockfile-а и изходните ви файлове. Останалото време е инсталирането и компилирането на 2 CPU.

### Какъв размер рънър да използва компилацията на Next.js в GitHub Actions?

Достатъчно памет за пика на компилацията. ubuntu-latest в частно хранилище има 2 CPU и 8 GB, а компилацията с webpack, проверката на типовете и source maps на голямо приложение на Next.js могат да надхвърлят това. По-големите рънъри на GitHub имат 16 GB при 4 ядра и 32 GB при 8, само в GitHub Team или Enterprise Cloud, на минута. Skipbox дава 16 GB с 8 vCPU с runs-on: skipbox-8x16 за $79 на месец и 32 GB с 16 vCPU с skipbox-16x32 за $149.

### Как да оправя JavaScript heap out of memory в компилация на Next.js в GitHub Actions?

Тази грешка е собственият лимит на heap на Node, не паметта на машината. Вдигнете го с NODE_OPTIONS=--max-old-space-size=<MiB>, зададен под паметта на машината. Ако после задачата завърши вместо това с exit code 137, на самата машина ѝ е свършила паметта: намалете паметта на компилацията (experimental.webpackMemoryOptimizations, без source maps в production) или изпълнете на машина с повече памет.

### Как да намаля използваната памет при компилацията на Next.js?

От ръководството на Next.js за паметта: опитайте experimental.webpackMemoryOptimizations (v15 и по-нови), оставете build worker-а на webpack включен (по подразбиране без собствена конфигурация на webpack от v14.1.0), изключете productionBrowserSourceMaps и experimental.serverSourceMaps и измервайте с next build --experimental-debug-memory-usage. Прескачането на проверката на типовете с typescript.ignoreBuildErrors спестява памет, но пропуска грешките в типовете, така че го правете само когато друга задача в CI проверява типовете.

### Пази ли Skipbox .next/cache между задачите?

Да. Отделната ви машина пази работното копие между задачите, а с него и .next/cache, където и да го е сложил Next.js (apps/web/.next/cache в monorepo), така че следващото next build започва от кеша на предишното без стъпка за кеша. Останалото от .next и другите непроследени файлове в работното копие се почистват след всяка задача. Кешът на npm или pnpm, версиите на Node, инсталирани от setup-node, и слоевете на Docker също остават на диска. Стъпка с actions/cache за .next/cache може да остане: задача на нова VM, например pull request от форк, възстановява от нея, а на отделната ви машина възстановяването оставя пазения кеш както е.

### Колко струва да го изпробвам?

Нищо. Пробният период е 7 дни или 3000 минути на задачи, което настъпи първо, без карта, на 4 vCPU и 16 GB: 2× 8-те GB на ubuntu-latest в частно хранилище и колкото по-големия рънър на GitHub с 4 ядра. Изпробвайте кеширането и паметта там; за компилация, която се нуждае от повече, изберете план L и сменете етикета на skipbox-16x32 (32 GB).

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