Skipbox

Build Next.js lambat atau kehabisan memori di GitHub Actions: cache, memori, ukuran runner

Build Next.js di GitHub Actions lambat karena satu alasan dan kehabisan memori karena alasan lain. Build lambat saat .next/cache tidak terbawa ke run berikutnya: Next.js memakai ulang cache itu di antara build, job yang dihosting GitHub dimulai di VM baru, dan tanpa step cache setiap build dimulai dingin (log-nya menulis No Cache Detected). Build kehabisan memori karena ubuntu-latest di repositori privat punya 8 GB, dan kompilasi webpack, type check, serta source map aplikasi yang besar bisa melewatinya. Perbaiki yang pertama dengan actions/cache pada .next/cache. Untuk yang kedua, setelan memori Next.js lebih dulu (experimental.webpackMemoryOptimizations, tanpa source map produksi); lalu mesin dengan memori lebih besar: 16 GB atau 32 GB.

Skipbox memberi build memori itu dengan harga tetap: 16 GB dan 8 vCPU di runs-on: skipbox-8x16 seharga $79 per bulan, 32 GB dan 16 vCPU di skipbox-16x32 seharga $149. Di mesin khusus untuk Anda, .next/cache tetap ada untuk build berikutnya, cache paket tetap ada di disk, dan apa yang disimpan actions/cache dibaca secara lokal, dengan menit tanpa batas.

Lambat: .next/cache dimulai kosong

Dari panduan CI build caching Next.js: Next.js "saves a cache to .next/cache that is shared between builds", dan CI yang tidak menyimpannya di antara build menampilkan error No Cache Detected. Step GitHub Actions-nya:

- 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-nya berubah di setiap perubahan source, jadi setiap run menyimpan entri baru, di dalam 10 GB per repositori milik GitHub. Di Turborepo, kecualikan .next/cache dari outputs task ("!.next/cache/**"), seperti di panduan GitHub Actions Turborepo.

Kehabisan memori: dua error yang berbeda

Menaikkan heap melebihi memori mesin mengubah error pertama menjadi error kedua.

Pakai memori lebih sedikit: setelan milik Next.js

Dari panduan pemakaian memori Next.js:

  • experimental.webpackMemoryOptimizations: true (v15.0.0 dan yang lebih baru) menurunkan puncak memori webpack, dengan kompilasi yang sedikit lebih lama.
  • Webpack build worker menjalankan kompilasi di worker Node terpisah, yang menurunkan memori. Fitur ini aktif secara default sejak v14.1.0 kecuali Anda punya konfigurasi webpack kustom; jika punya, atur experimental.webpackBuildWorker: true.
  • Source map dimatikan: productionBrowserSourceMaps: false dan experimental.serverSourceMaps: false. Jika build kehabisan memori saat "Generating static pages", tambahkan juga enablePrerenderSourceMaps: false.
  • Ukur: next build --experimental-debug-memory-usage (v14.2.0 dan yang lebih baru) mencetak pemakaian heap sepanjang build, dan mengambil heap snapshot saat mendekati batas.
  • Type checking: typescript.ignoreBuildErrors: true melewati type check dan memorinya, dan meloloskan error tipe ke dalam build. Next.js memperingatkan agar tidak memakainya kecuali ada step lain yang melakukan type check.

Pakai mesin dengan memori lebih besar

Untuk 20.000 menit per bulan, runner 8-core GitHub berbiaya $422 dan Skipbox M $79; di 16 core, $822 dibandingkan $149 untuk L. Angka GitHub adalah setelah dikurangi kuota bawaan GitHub Team.

Yang dilakukan Skipbox untuk build Next.js

Setiap paket datang dengan mesin khusus untuk akun Anda, yang disimpan di antara job:

  • Memori yang dibutuhkan build, sesuai label: 16 GB di M, 32 GB di L. Sesuaikan heap-nya, misalnya --max-old-space-size=12288 di M.
  • Cache paket tetap ada di disk: ~/.npm, store pnpm, ~/.cache setiap tool, dan versi Node yang dipasang setup-node. npm ci membacanya alih-alih registry.
  • .next/cache tetap ada untuk job berikutnya. Mesin menyimpan checkout Anda di antara job, termasuk .next/cache di dalamnya, sedalam apa pun monorepo menaruhnya (apps/web/.next/cache). next build berikutnya mulai dari situ, tanpa step cache dan tanpa No Cache Detected. Isi .next lainnya dan file lain yang tidak dilacak di checkout dibersihkan setelah setiap job.
  • Pemulihan actions/cache membaca mesin. Apa yang disimpannya tetap berada di samping mesin, dengan ruang lebih besar dari 10 GB per repositori milik GitHub, dan pemulihannya berupa pembacaan lokal. Pertahankan step .next/cache untuk job yang berjalan di VM baru; di mesin khusus untuk Anda, pemulihan membiarkan cache yang disimpan apa adanya.
  • Core lebih banyak dengan harga tetap. Kompilasi dan pembuatan halaman statis memakainya, dan menitnya tanpa batas.

Pindah cukup satu baris

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 di paket M; uji coba menjalankan runs-on: skipbox.

  1. Masuk ke Skipbox dengan GitHub.
  2. Instal aplikasi GitHub Skipbox dan pilih repositorinya.
  3. Ubah runs-on, lalu push.

Keamanan

  • Mesinnya hanya milik akun Anda. Tidak ada job perusahaan lain yang berjalan di sana.
  • Setelah setiap job, kredensial runner, proses, dan container dihapus, begitu juga kredensial git di checkout yang disimpan dan file-nya yang tidak dilacak, kecuali cache build seperti .next/cache. Bersih setiap job memberi setiap job mesin baru sebagai gantinya.
  • Kode dari orang tanpa akses tulis (misalnya pull request dari fork) berjalan di VM baru yang bisa membaca cache Anda tetapi tidak bisa mengubahnya.

Detailnya ada di cara job diisolasi.

Coba di build Next.js Anda

Uji cobanya gratis selama 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu. Uji coba menjalankan runs-on: skipbox, dengan 16 GB, 2× memori ubuntu-latest di repositori privat: coba cache dan memorinya di sana, lalu pindahkan build yang butuh lebih ke paket L (skipbox-16x32, 32 GB).

FAQ

Kenapa next build lambat di GitHub Actions?

Biasanya karena .next/cache dimulai kosong. Next.js menyimpan build cache ke .next/cache dan memakainya ulang di build berikutnya, tetapi job yang dihosting GitHub adalah VM baru, jadi tanpa step yang membawa .next/cache, setiap build dimulai dingin dan log-nya memperingatkan No Cache Detected. Tambahkan actions/cache untuk .next/cache dengan key dari lockfile dan file source Anda. Sisa waktunya adalah instalasi dan kompilasi di 2 CPU.

Ukuran runner apa yang sebaiknya dipakai build Next.js di GitHub Actions?

Memori yang cukup untuk puncak build. ubuntu-latest di repositori privat punya 2 CPU dan 8 GB, dan build webpack, type check, serta source map aplikasi Next.js yang besar bisa melewatinya. Larger runner GitHub punya 16 GB di 4 core dan 32 GB di 8, hanya di GitHub Team atau Enterprise Cloud, per menit. Skipbox memberi 16 GB dengan 8 vCPU di runs-on: skipbox-8x16 seharga $79 per bulan, dan 32 GB dengan 16 vCPU di skipbox-16x32 seharga $149.

Bagaimana memperbaiki JavaScript heap out of memory di build Next.js pada GitHub Actions?

Error itu adalah batas heap milik Node sendiri, bukan memori mesin. Naikkan dengan NODE_OPTIONS=--max-old-space-size=<MiB>, di bawah memori mesin. Jika job lalu berakhir dengan exit code 137, mesinnya sendiri yang kehabisan memori: pangkas memori build (experimental.webpackMemoryOptimizations, tanpa source map produksi) atau jalankan di mesin dengan memori lebih besar.

Bagaimana mengurangi pemakaian memori build Next.js?

Dari panduan memori Next.js: coba experimental.webpackMemoryOptimizations (v15 dan yang lebih baru), biarkan webpack build worker aktif (default tanpa konfigurasi webpack kustom sejak v14.1.0), matikan productionBrowserSourceMaps dan experimental.serverSourceMaps, dan ukur dengan next build --experimental-debug-memory-usage. Melewati type checking dengan typescript.ignoreBuildErrors menghemat memori tetapi meloloskan error tipe, jadi lakukan hanya jika ada job CI lain yang melakukan type check.

Apakah Skipbox menyimpan .next/cache di antara job?

Ya. Mesin khusus untuk Anda menyimpan checkout di antara job, termasuk .next/cache di dalamnya, di mana pun Next.js menaruhnya (apps/web/.next/cache di monorepo), jadi next build berikutnya mulai dari cache build sebelumnya tanpa step cache. Isi .next lainnya dan file lain yang tidak dilacak di checkout dibersihkan setelah setiap job. Cache npm atau pnpm, versi Node yang dipasang setup-node, dan layer Docker juga tetap ada di disk. Step actions/cache untuk .next/cache boleh tetap ada: job di VM baru, seperti pull request dari fork, memulihkan dari step itu, dan di mesin khusus untuk Anda pemulihan membiarkan cache yang disimpan apa adanya.

Berapa biaya untuk mencobanya?

Gratis. Uji cobanya 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu, di 4 vCPU dan 16 GB: 2× 8 GB milik ubuntu-latest di repositori privat, dan sama dengan larger runner 4-core GitHub. Coba caching dan memorinya di sana; untuk build yang butuh lebih, pilih paket L dan ubah label-nya menjadi skipbox-16x32 (32 GB).

Diperbarui 19 November 2026

CI/CD lebih cepat dengan cache yang selalu hangat

Runner hangat Anda dengan harga tetap

Kami yang meng-hosting. Anda mengubah satu baris. 1/12 biaya GitHub saat dipakai penuh. Harga tetap, jadi bisa jalan seharian. Ruang cache 7× GitHub.

  • Tanpa kartu
  • Masuk dengan GitHub
  • Batalkan kapan saja