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
| Di log | Apa yang habis | Yang perlu dilakukan |
|---|---|---|
JavaScript heap out of memory | Batas heap milik Node sendiri; mesinnya masih punya memori | Naikkan: NODE_OPTIONS=--max-old-space-size=6144, di bawah memori mesin |
Process completed with exit code 137 | Memori mesin: Linux menghentikan prosesnya | Pakai memori lebih sedikit, atau mesin dengan memori lebih besar |
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: falsedanexperimental.serverSourceMaps: false. Jika build kehabisan memori saat "Generating static pages", tambahkan jugaenablePrerenderSourceMaps: 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: truemelewati 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
| Runner | CPU dan memori | Siapa yang bisa memakainya |
|---|---|---|
ubuntu-latest GitHub, repositori privat | 2 CPU, 8 GB | Semua orang |
ubuntu-latest GitHub, repositori publik | 4 CPU, 16 GB | Repositori publik |
| Larger runner GitHub, 4 atau 8 core | 16 GB atau 32 GB | Organisasi GitHub Team dan Enterprise Cloud, per menit (larger runners) |
Skipbox skipbox-8x16 | 8 vCPU, 16 GB | Organisasi dan akun pribadi, $79 per bulan |
Skipbox skipbox-16x32 | 16 vCPU, 32 GB | Organisasi dan akun pribadi, $149 per bulan |
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=12288di M. - Cache paket tetap ada di disk:
~/.npm, store pnpm,~/.cachesetiap tool, dan versi Node yang dipasangsetup-node.npm cimembacanya alih-alih registry. .next/cachetetap ada untuk job berikutnya. Mesin menyimpan checkout Anda di antara job, termasuk.next/cachedi dalamnya, sedalam apa pun monorepo menaruhnya (apps/web/.next/cache).next buildberikutnya mulai dari situ, tanpa step cache dan tanpaNo Cache Detected. Isi.nextlainnya dan file lain yang tidak dilacak di checkout dibersihkan setelah setiap job.- Pemulihan
actions/cachemembaca 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/cacheuntuk 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.
| Label | Mesin | Paket |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, $39 per bulan |
skipbox-8x16 | 8 vCPU · 16 GB | M, $79 per bulan |
skipbox-16x32 | 16 vCPU · 32 GB | L, $149 per bulan |
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.
- Masuk ke Skipbox dengan GitHub.
- Instal aplikasi GitHub Skipbox dan pilih repositorinya.
- 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