# Build Next.js perlahan atau kehabisan memori dalam GitHub Actions: cache, memori, saiz runner

> Build Next.js dalam GitHub Actions perlahan apabila .next/cache tidak dibawa ke larian seterusnya, dan kehabisan memori pada ubuntu-latest 8 GB repositori peribadi sebaik webpack, semakan jenis dan source map bertambah. Apa yang perlu disimpan dalam cache, tetapan Next.js mana yang mengurangkan memori, dan saiz runner: 16 GB untuk $79 sebulan atau 32 GB untuk $149 di Skipbox, di mana .next/cache kekal antara job dan minit tanpa had.

Build Next.js dalam GitHub Actions perlahan atas satu sebab dan kehabisan memori atas sebab lain. Ia perlahan apabila `.next/cache` tidak dibawa ke larian seterusnya: Next.js menggunakan semula cache itu antara build, job yang dihoskan GitHub bermula pada VM baharu, dan tanpa step cache setiap build ialah build sejuk (log menyatakan `No Cache Detected`). Ia kehabisan memori kerana `ubuntu-latest` repositori peribadi mempunyai 8 GB, dan kompilasi webpack, semakan jenis dan source map app yang besar boleh melepasinya. Betulkan yang pertama dengan `actions/cache` pada `.next/cache`. Untuk yang kedua, tetapan memori Next.js didahulukan (`experimental.webpackMemoryOptimizations`, tiada source map production); kemudian mesin dengan lebih banyak memori: 16 GB atau 32 GB.

Skipbox memberi build memori itu pada harga tetap: 16 GB dan 8 vCPU pada `runs-on: skipbox-8x16` untuk $79 sebulan, 32 GB dan 16 vCPU pada `skipbox-16x32` untuk $149. Pada mesin khusus untuk anda `.next/cache` kekal untuk build seterusnya, cache pakej kekal pada cakera, dan apa yang disimpan `actions/cache` dibaca secara setempat, dengan minit tanpa had.

- `.next/cache` kekal pada mesin khusus untuk anda: build seterusnya menggunakan semula kompilasi terakhirnya, tanpa step cache
- 16 GB untuk $79 sebulan atau 32 GB untuk $149, berbanding 8 GB pada `ubuntu-latest` peribadi
- Cache pakej kekal pada mesin anda, dan pemulihan cache membaca cakeranya dan bukannya memuat turun

**GitHub Actions pada harga tetap, minit tanpa had** Skipbox menjalankan job GitHub Actions anda pada mesin khusus anda sendiri: $39 sebulan, berapa minit pun anda jalankan. Lapisan Docker dan cache dependency kekal antara job, jadi job seterusnya bermula serta-merta.

Runner 4 vCPU, 20,000 minit sebulan: GitHub $222 → Skipbox $39. Anda jimat $183 setiap bulan.

Beralih hanya memerlukan satu baris: `runs-on: skipbox`.

[Mulakan percubaan percuma 7 hari saya](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-ms)

## Perlahan: .next/cache bermula kosong

Daripada [panduan cache build CI](https://nextjs.org/docs/app/guides/ci-build-caching) Next.js: Next.js "saves a cache to `.next/cache` that is shared between builds", dan CI yang tidak mengekalkannya antara build menunjukkan ralat `No Cache Detected`. Step GitHub Actions-nya:

```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') }}-
```

Key berubah dengan setiap perubahan sumber, jadi setiap larian menyimpan entri baharu, di dalam 10 GB GitHub bagi setiap repositori. Dalam Turborepo, kecualikan `.next/cache` daripada `outputs` tugas (`"!.next/cache/**"`), seperti yang dilakukan [panduan GitHub Actions Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions).

## Kehabisan memori: dua ralat yang berbeza

| Dalam log | Apa yang habis | Apa yang perlu dilakukan |
|---|---|---|
| `JavaScript heap out of memory` | Had heap Node sendiri; mesin masih mempunyai memori | Naikkannya: `NODE_OPTIONS=--max-old-space-size=6144`, di bawah memori mesin |
| `Process completed with exit code 137` | Memori mesin: Linux menghentikan proses | Gunakan kurang memori, atau mesin dengan lebih banyak |

Menaikkan heap melebihi memori mesin menukar ralat pertama kepada ralat kedua.

## Gunakan kurang memori: tetapan Next.js sendiri

Daripada [panduan penggunaan memori](https://nextjs.org/docs/app/guides/memory-usage) Next.js:

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 dan kemudian) menurunkan puncak memori webpack, dengan kompilasi yang sedikit lebih lama.
- **Webpack build worker** menjalankan kompilasi dalam worker Node yang berasingan, yang menurunkan memori. Ia dihidupkan secara lalai sejak v14.1.0 melainkan anda mempunyai konfigurasi webpack tersuai; jika ada, tetapkan `experimental.webpackBuildWorker: true`.
- **Source map dimatikan:** `productionBrowserSourceMaps: false` dan `experimental.serverSourceMaps: false`. Jika build kehabisan memori semasa "Generating static pages", `enablePrerenderSourceMaps: false` juga.
- **Ukur:** `next build --experimental-debug-memory-usage` (v14.2.0 dan kemudian) mencetak penggunaan heap sepanjang build, dan mengambil snapshot heap berhampiran had.
- **Semakan jenis:** `typescript.ignoreBuildErrors: true` melangkau semakan jenis dan memorinya, dan membiarkan ralat jenis masuk ke build. Next.js memberi amaran terhadapnya melainkan step lain menyemak jenis.

## Gunakan mesin dengan lebih banyak memori

| Runner | CPU dan memori | Siapa yang boleh menggunakannya |
|---|---|---|
| GitHub `ubuntu-latest`, repositori peribadi | 2 CPU, 8 GB | Semua orang |
| GitHub `ubuntu-latest`, repositori awam | 4 CPU, 16 GB | Repositori awam |
| Larger runner GitHub, 4 atau 8 teras | 16 GB atau 32 GB | Organisasi GitHub Team dan Enterprise Cloud, ikut minit ([larger runner](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | Organisasi dan akaun peribadi, $79 sebulan |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | Organisasi dan akaun peribadi, $149 sebulan |

Pada 20,000 minit sebulan, runner 8 teras GitHub ialah $422 dan Skipbox M ialah $79; pada 16 teras, $822 berbanding $149 untuk L. Angka GitHub ialah selepas penggunaan yang disertakan dalam GitHub Team.

## Apa yang dilakukan Skipbox untuk build Next.js

Setiap pelan disertakan dengan mesin khusus akaun anda, dikekalkan antara job:

- **Memori yang diperlukan build**, mengikut label: 16 GB pada M, 32 GB pada L. Tetapkan heap supaya sepadan, seperti `--max-old-space-size=12288` pada M.
- **Cache pakej kekal pada cakera:** `~/.npm`, stor pnpm, `~/.cache` setiap alat, dan versi Node yang dipasang oleh `setup-node`. `npm ci` membacanya dan bukannya registry.
- **`.next/cache` kekal untuk job seterusnya.** Mesin mengekalkan checkout anda antara job, dan `.next/cache` di dalamnya, pada apa jua kedalaman yang diletakkan monorepo (`apps/web/.next/cache`). `next build` seterusnya bermula daripadanya, tanpa step cache dan tanpa `No Cache Detected`. Selebihnya `.next` dan fail lain yang tidak dijejak dalam checkout dibersihkan selepas setiap job.
- **Pemulihan `actions/cache` membaca mesin.** Apa yang disimpannya kekal bersebelahan dengan mesin, dengan lebih banyak ruang daripada 10 GB GitHub bagi setiap repositori, dan pemulihan ialah bacaan setempat. Kekalkan step `.next/cache` untuk job yang berjalan pada VM baharu; pada mesin khusus untuk anda pemulihan itu membiarkan cache yang dikekalkan seperti sedia ada.
- **Lebih banyak teras pada harga tetap.** Kompilasi dan penjanaan halaman statik menggunakannya, dan minit tanpa had.

| Label | Mesin | Pelan |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 sebulan |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 sebulan |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 sebulan |

## Beralih hanya satu baris

```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` berjalan pada pelan M; percubaan menjalankan `runs-on: skipbox`.

1. Log masuk ke Skipbox dengan GitHub.
2. Pasang GitHub App Skipbox dan pilih repositori.
3. Tukar `runs-on` dan push.

## Keselamatan

- Mesin itu milik akaun anda seorang. Tiada job syarikat lain berjalan padanya.
- Selepas setiap job, bukti kelayakan, proses dan container runner dipadam, begitu juga bukti kelayakan git dalam checkout yang dikekalkan dan fail tidak dijejaknya selain cache build seperti `.next/cache`. “VM baharu bagi setiap job” memberi setiap job mesin baharu sebaliknya.
- Kod daripada orang tanpa akses tulis (seperti pull request daripada fork) berjalan pada VM baharu yang membaca cache anda tetapi tidak boleh mengubahnya.

Butirannya dalam [cara job diasingkan](https://docs.skipbox.dev/ms/isolation).

## Cuba pada build Next.js

Percubaan adalah percuma selama 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad. Ia menjalankan `runs-on: skipbox`, dengan 16 GB, 2× memori `ubuntu-latest` repositori peribadi: cuba cache dan memori di sana, dan pindahkan build yang memerlukan lebih ke pelan L (`skipbox-16x32`, 32 GB).

## Soalan lazim

### Kenapa next build perlahan dalam GitHub Actions?

Biasanya kerana .next/cache bermula kosong. Next.js menyimpan cache build ke .next/cache dan menggunakannya semula pada build seterusnya, tetapi job yang dihoskan GitHub ialah VM baharu, jadi tanpa step yang membawa .next/cache, setiap build ialah build sejuk dan log memberi amaran No Cache Detected. Tambah actions/cache untuk .next/cache dengan key berdasarkan lockfile dan fail sumber anda. Baki masa ialah pemasangan dan kompilasi pada 2 CPU.

### Apakah saiz runner yang patut digunakan untuk build Next.js dalam GitHub Actions?

Memori yang cukup untuk puncak build. ubuntu-latest repositori peribadi mempunyai 2 CPU dan 8 GB, dan build webpack, semakan jenis dan source map app Next.js yang besar boleh melepasinya. Larger runner GitHub mempunyai 16 GB pada 4 teras dan 32 GB pada 8, hanya pada GitHub Team atau Enterprise Cloud, ikut minit. Skipbox memberi 16 GB dengan 8 vCPU pada runs-on: skipbox-8x16 untuk $79 sebulan, dan 32 GB dengan 16 vCPU pada skipbox-16x32 untuk $149.

### Bagaimanakah cara membetulkan JavaScript heap out of memory dalam build Next.js di GitHub Actions?

Ralat itu ialah had heap Node sendiri, bukan memori mesin. Naikkannya dengan NODE_OPTIONS=--max-old-space-size=<MiB>, ditetapkan di bawah memori mesin. Jika job kemudian tamat dengan exit code 137, mesin itu sendiri kehabisan memori: kurangkan memori build (experimental.webpackMemoryOptimizations, tiada source map production) atau jalankan pada mesin dengan lebih banyak memori.

### Bagaimanakah cara mengurangkan penggunaan memori build Next.js?

Daripada panduan memori Next.js: cuba experimental.webpackMemoryOptimizations (v15 dan kemudian), biarkan webpack build worker hidup (lalai tanpa konfigurasi webpack tersuai sejak v14.1.0), matikan productionBrowserSourceMaps dan experimental.serverSourceMaps, dan ukur dengan next build --experimental-debug-memory-usage. Melangkau semakan jenis dengan typescript.ignoreBuildErrors menjimatkan memori tetapi membiarkan ralat jenis lepas, jadi lakukannya hanya apabila job CI lain menyemak jenis.

### Adakah Skipbox mengekalkan .next/cache antara job?

Ya. Mesin khusus untuk anda mengekalkan checkout antara job, dan .next/cache di dalamnya, di mana sahaja Next.js meletakkannya (apps/web/.next/cache dalam monorepo), jadi next build seterusnya bermula daripada cache build terakhir tanpa step cache. Selebihnya .next dan fail lain yang tidak dijejak dalam checkout dibersihkan selepas setiap job. Cache npm atau pnpm, versi Node yang dipasang setup-node dan lapisan Docker juga kekal pada cakera. Step actions/cache untuk .next/cache boleh kekal: job pada VM baharu, seperti pull request daripada fork, memulihkan daripadanya, dan pada mesin khusus untuk anda pemulihan itu membiarkan cache yang dikekalkan seperti sedia ada.

### Berapakah kos untuk mencuba?

Tiada. Percubaan ialah 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad, pada 4 vCPU dan 16 GB: 2× 8 GB ubuntu-latest pada repositori peribadi, dan sama dengan larger runner 4 teras GitHub. Cuba cache dan memori di sana; untuk build yang memerlukan lebih, pilih pelan L dan tukar label kepada skipbox-16x32 (32 GB).

Dikemas kini 2026-11-19 · https://skipbox.dev/ms/guides/nextjs-build-slow-out-of-memory-github-actions
