Skipbox

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 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.

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

Theo hướng dẫn 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ọ:

- 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 làm.

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

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ớ 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

Ở 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.

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

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.

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 16 tháng 11, 2026

CI/CD nhanh hơn với cache luôn sẵn sàng

Runner luôn sẵn cache, giá cố định

Chúng tôi host. Bạn đổi một dòng. Chỉ bằng 1/12 chi phí GitHub khi chạy hết công suất. Giá cố định nên bạn chạy cả ngày cũng được. Dung lượng cache gấp 7 lần GitHub.

  • Không cần thẻ
  • Đăng nhập bằng GitHub
  • Hủy bất cứ lúc nào