# Bản build Next.js chậm hoặc hết bộ nhớ trên GitHub Actions: cache, bộ nhớ, kích thước runner

> Bản build Next.js trên GitHub Actions chậm khi .next/cache không được mang sang lần chạy sau, và hết bộ nhớ trên ubuntu-latest 8 GB của repository riêng tư khi webpack, kiểm tra kiểu và source map cộng dồn lại. Nên cache gì, thiết lập Next.js nào giảm bộ nhớ, và kích thước runner: 16 GB với $79 một tháng hoặc 32 GB với $149 trên Skipbox, nơi .next/cache được giữ giữa các job và không giới hạn phút.

Bản build Next.js trên GitHub Actions chậm vì một lý do và hết bộ nhớ vì một lý do khác. Nó chậm khi `.next/cache` không được mang sang lần chạy sau: Next.js dùng lại cache đó giữa các bản build, job do GitHub host khởi đầu trên một VM mới, và không có step cache thì bản build nào cũng nguội (log ghi `No Cache Detected`). Nó hết bộ nhớ vì `ubuntu-latest` của repository riêng tư có 8 GB, và phần biên dịch webpack, kiểm tra kiểu và source map của một ứng dụng lớn có thể vượt mức đó. Sửa cái đầu bằng `actions/cache` trên `.next/cache`. Với cái thứ hai, trước hết là các thiết lập bộ nhớ của Next.js (`experimental.webpackMemoryOptimizations`, không source map cho production); sau đó là một cái máy nhiều bộ nhớ hơn: 16 GB hoặc 32 GB.

Skipbox cho bản build lượng bộ nhớ đó với giá cố định: 16 GB và 8 vCPU trên `runs-on: skipbox-8x16` với $79 một tháng, 32 GB và 16 vCPU trên `skipbox-16x32` với $149. Trên máy riêng của bạn, `.next/cache` được giữ cho lần build sau, cache package nằm lại trên ổ đĩa và những gì `actions/cache` lưu được đọc tại chỗ, không giới hạn phút.

- `.next/cache` được giữ trên máy riêng của bạn: bản build sau dùng lại lần biên dịch trước, không cần step cache
- 16 GB với $79 một tháng hoặc 32 GB với $149, so với 8 GB trên `ubuntu-latest` riêng tư
- Cache package nằm lại trên máy của bạn, và khôi phục cache đọc ổ đĩa của máy thay vì tải về

**GitHub Actions giá cố định, không giới hạn phút** Skipbox chạy job GitHub Actions của bạn trên máy riêng dành cho bạn: $39 một tháng, dù bạn chạy bao nhiêu phút. Docker layer và cache dependency được giữ giữa các job, nên job tiếp theo khởi chạy ngay.

Runner 4 vCPU, 20.000 phút một tháng: GitHub $222 → Skipbox $39. Bạn tiết kiệm $183 mỗi tháng.

Chỉ cần đổi một dòng: `runs-on: skipbox`.

[Bắt đầu dùng thử miễn phí 7 ngày](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-vi)

## Chậm: .next/cache khởi đầu trống

Theo [hướng dẫn CI build caching](https://nextjs.org/docs/app/guides/ci-build-caching) của Next.js: Next.js lưu một cache vào `.next/cache` dùng chung giữa các bản build, và CI nào không giữ nó giữa các bản build sẽ báo lỗi `No Cache Detected`. Step GitHub Actions của họ:

```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 thay đổi theo mỗi thay đổi mã nguồn, nên mỗi lần chạy lưu một mục mới, trong 10 GB mỗi repository của GitHub. Trong Turborepo, hãy loại `.next/cache` khỏi `outputs` của task (`"!.next/cache/**"`), như [hướng dẫn GitHub Actions của Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions) làm.

## Hết bộ nhớ: hai lỗi khác nhau

| Trong log | Cái gì đã hết | Làm gì |
|---|---|---|
| `JavaScript heap out of memory` | Giới hạn heap của chính Node; máy vẫn còn bộ nhớ | Nâng nó: `NODE_OPTIONS=--max-old-space-size=6144`, thấp hơn bộ nhớ của máy |
| `Process completed with exit code 137` | Bộ nhớ của máy: Linux đã dừng tiến trình | Dùng ít bộ nhớ hơn, hoặc dùng máy nhiều bộ nhớ hơn |

Nâng heap vượt bộ nhớ của máy sẽ biến lỗi thứ nhất thành lỗi thứ hai.

## Dùng ít bộ nhớ hơn: các thiết lập của chính Next.js

Theo [hướng dẫn mức dùng bộ nhớ](https://nextjs.org/docs/app/guides/memory-usage) của Next.js:

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 trở lên) giảm bộ nhớ đỉnh của webpack, đổi lại thời gian biên dịch dài hơn một chút.
- **Webpack build worker** chạy phần biên dịch trong một Node worker riêng, giúp giảm bộ nhớ. Nó bật mặc định từ v14.1.0 trừ khi bạn có cấu hình webpack tùy chỉnh; nếu có, hãy đặt `experimental.webpackBuildWorker: true`.
- **Tắt source map:** `productionBrowserSourceMaps: false` và `experimental.serverSourceMaps: false`. Nếu bản build hết bộ nhớ trong lúc "Generating static pages", thêm cả `enablePrerenderSourceMaps: false`.
- **Đo:** `next build --experimental-debug-memory-usage` (v14.2.0 trở lên) in mức dùng heap suốt bản build, và chụp heap snapshot khi gần chạm giới hạn.
- **Kiểm tra kiểu:** `typescript.ignoreBuildErrors: true` bỏ qua bước kiểm tra kiểu cùng bộ nhớ của nó, và để lỗi kiểu lọt vào bản build. Next.js khuyên không nên làm vậy trừ khi có một step khác kiểm tra kiểu.

## Dùng máy nhiều bộ nhớ hơn

| Runner | CPU và bộ nhớ | Ai dùng được |
|---|---|---|
| GitHub `ubuntu-latest`, repository riêng tư | 2 CPU, 8 GB | Mọi người |
| GitHub `ubuntu-latest`, repository công khai | 4 CPU, 16 GB | Repository công khai |
| Larger runner của GitHub, 4 hoặc 8 nhân | 16 GB hoặc 32 GB | Tổ chức dùng GitHub Team và Enterprise Cloud, tính theo phút ([larger runners](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | Tổ chức và tài khoản cá nhân, $79 một tháng |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | Tổ chức và tài khoản cá nhân, $149 một tháng |

Ở mức 20.000 phút mỗi tháng, runner 8 nhân của GitHub là $422 còn Skipbox M là $79; ở 16 nhân, $822 so với $149 cho L. Số liệu GitHub là sau khi trừ mức sử dụng có sẵn của GitHub Team.

## Skipbox làm gì cho một bản build Next.js

Mỗi gói đi kèm máy riêng của tài khoản bạn, được giữ lại giữa các job:

- **Lượng bộ nhớ bản build cần**, theo nhãn: 16 GB ở M, 32 GB ở L. Đặt heap cho khớp, chẳng hạn `--max-old-space-size=12288` trên M.
- **Cache package nằm lại trên ổ đĩa:** `~/.npm`, pnpm store, `~/.cache` của từng tool, và các phiên bản Node mà `setup-node` đã cài. `npm ci` đọc chúng thay vì đọc từ registry.
- **`.next/cache` được giữ cho job sau.** Máy giữ bản checkout của bạn giữa các job, cùng `.next/cache` trong đó, dù monorepo đặt nó sâu đến đâu (`apps/web/.next/cache`). Lần `next build` sau bắt đầu từ đó, không cần step cache và không còn `No Cache Detected`. Phần còn lại của `.next` và các file không được track khác trong bản checkout bị dọn sau mỗi job.
- **Khôi phục `actions/cache` đọc từ máy.** Những gì nó lưu nằm cạnh máy, với nhiều chỗ hơn 10 GB mỗi repository của GitHub, và khôi phục là một lần đọc tại chỗ. Hãy giữ step `.next/cache` cho các job chạy trên VM mới; trên máy riêng của bạn, việc khôi phục để nguyên cache đã giữ.
- **Nhiều nhân hơn với giá cố định.** Phần biên dịch và việc tạo trang tĩnh dùng tới chúng, và không giới hạn phút.

| Nhãn | Máy | Gói |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 một tháng |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 một tháng |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 một tháng |

## Chuyển sang chỉ cần một dòng

```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` chạy trên gói M; bản dùng thử chạy `runs-on: skipbox`.

1. Đăng nhập Skipbox bằng GitHub.
2. Cài ứng dụng GitHub của Skipbox và chọn các repository.
3. Đổi `runs-on` rồi push.

## Bảo mật

- Máy chỉ thuộc về tài khoản của bạn. Không có job của công ty nào khác chạy trên đó.
- Sau mỗi job, thông tin xác thực, tiến trình và container của runner bị xóa, cùng thông tin xác thực git và các file không được track (trừ cache build như `.next/cache`) trong bản checkout được giữ lại. Bật VM mới cho mỗi job thì mỗi job chạy trên một máy mới.
- Code từ người không có quyền ghi (chẳng hạn pull request từ fork) chạy trên một VM mới, đọc được cache của bạn nhưng không sửa được.

Chi tiết có trong [cách các job được cách ly](https://docs.skipbox.dev/vi/isolation).

## Thử trên bản build Next.js

Dùng thử miễn phí trong 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Nó chạy `runs-on: skipbox`, với 16 GB, gấp 2 lần bộ nhớ của `ubuntu-latest` trên repository riêng tư: hãy thử cache và bộ nhớ ở đó, rồi chuyển bản build nào cần nhiều hơn sang gói L (`skipbox-16x32`, 32 GB).

## Câu hỏi thường gặp

### Vì sao next build chậm trên GitHub Actions?

Thường là vì .next/cache khởi đầu trống. Next.js lưu build cache vào .next/cache và dùng lại nó ở bản build sau, nhưng job do GitHub host là một VM mới, nên không có step mang .next/cache sang thì bản build nào cũng là build nguội và log cảnh báo No Cache Detected. Hãy thêm actions/cache cho .next/cache với key theo lockfile và các file mã nguồn. Phần thời gian còn lại là cài đặt và biên dịch trên 2 CPU.

### Bản build Next.js nên dùng runner cỡ nào trên GitHub Actions?

Đủ bộ nhớ cho mức đỉnh của bản build. ubuntu-latest của repository riêng tư có 2 CPU và 8 GB, và bản build webpack, kiểm tra kiểu và source map của một ứng dụng Next.js lớn có thể vượt mức đó. Larger runner của GitHub có 16 GB ở 4 nhân và 32 GB ở 8, chỉ trên GitHub Team hoặc Enterprise Cloud, tính theo phút. Skipbox cho 16 GB với 8 vCPU trên runs-on: skipbox-8x16 với $79 một tháng, và 32 GB với 16 vCPU trên skipbox-16x32 với $149.

### Sửa JavaScript heap out of memory trong bản build Next.js trên GitHub Actions thế nào?

Lỗi đó là giới hạn heap của chính Node, không phải bộ nhớ của máy. Nâng nó bằng NODE_OPTIONS=--max-old-space-size=<MiB>, đặt thấp hơn bộ nhớ của máy. Nếu sau đó job lại kết thúc với exit code 137, thì chính cái máy đã hết bộ nhớ: giảm bộ nhớ của bản build (experimental.webpackMemoryOptimizations, không source map cho production) hoặc chạy trên máy nhiều bộ nhớ hơn.

### Giảm bộ nhớ khi build Next.js thế nào?

Theo hướng dẫn bộ nhớ của Next.js: thử experimental.webpackMemoryOptimizations (v15 trở lên), giữ webpack build worker bật (mặc định khi không có cấu hình webpack tùy chỉnh từ v14.1.0), tắt productionBrowserSourceMaps và experimental.serverSourceMaps, và đo bằng next build --experimental-debug-memory-usage. Bỏ kiểm tra kiểu bằng typescript.ignoreBuildErrors tiết kiệm bộ nhớ nhưng để lọt lỗi kiểu, nên chỉ làm khi đã có một job CI khác kiểm tra kiểu.

### Skipbox có giữ .next/cache giữa các job không?

Có. Máy riêng của bạn giữ bản checkout giữa các job, cùng .next/cache trong đó, dù Next.js đặt nó ở đâu (apps/web/.next/cache trong monorepo), nên lần next build sau bắt đầu từ cache của lần trước mà không cần step cache. Phần còn lại của .next và các file không được track khác trong bản checkout bị dọn sau mỗi job. Cache của npm hoặc pnpm, các phiên bản Node mà setup-node đã cài và Docker layer cũng nằm lại trên ổ đĩa. Step actions/cache cho .next/cache có thể giữ nguyên: job chạy trên VM mới, như pull request từ fork, khôi phục từ step đó, còn trên máy riêng của bạn, việc khôi phục để nguyên cache đã giữ.

### Thử thì tốn bao nhiêu?

Không tốn gì. Dùng thử kéo dài 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ, trên 4 vCPU và 16 GB: gấp 2 lần 8 GB của ubuntu-latest trên repository riêng tư, và bằng larger runner 4 nhân của GitHub. Hãy thử cache và bộ nhớ ở đó; bản build nào cần nhiều hơn thì chọn gói L và đổi nhãn thành skipbox-16x32 (32 GB).

Cập nhật ngày 2026-11-16 · https://skipbox.dev/vi/guides/nextjs-build-slow-out-of-memory-github-actions
