# build ของ Next.js ช้าหรือหน่วยความจำหมดใน GitHub Actions: แคช หน่วยความจำ ขนาดรันเนอร์

> build ของ Next.js ใน GitHub Actions ช้าเมื่อ .next/cache ไม่ถูกส่งต่อไปยังการรันถัดไป และหน่วยความจำหมดบน ubuntu-latest 8 GB ของรีโพสิทอรีส่วนตัวเมื่อ webpack การตรวจ type และ source map รวมกันเกิน ควรแคชอะไร การตั้งค่าไหนของ Next.js ลดหน่วยความจำ และขนาดรันเนอร์: 16 GB ในราคา $79 ต่อเดือน หรือ 32 GB ในราคา $149 บน Skipbox ซึ่ง .next/cache อยู่ต่อระหว่างจ็อบ และไม่จำกัดนาที

build ของ Next.js ใน GitHub Actions ช้าด้วยเหตุผลหนึ่ง และหน่วยความจำหมดด้วยอีกเหตุผลหนึ่ง มันช้าเมื่อ `.next/cache` ไม่ถูกส่งต่อไปยังการรันถัดไป: Next.js ใช้แคชนั้นซ้ำระหว่าง build จ็อบบนรันเนอร์ที่ GitHub โฮสต์เริ่มบน VM ใหม่ และถ้าไม่มีขั้นตอนแคช ทุก build จะเป็น build เย็น (log บอกว่า `No Cache Detected`) มันหน่วยความจำหมดเพราะ `ubuntu-latest` ของรีโพสิทอรีส่วนตัวมี 8 GB และการคอมไพล์ webpack การตรวจ type และ source map ของแอปขนาดใหญ่อาจเกินนั้น แก้อย่างแรกด้วย `actions/cache` บน `.next/cache` สำหรับอย่างที่สอง การตั้งค่าหน่วยความจำของ Next.js มาก่อน (`experimental.webpackMemoryOptimizations` ไม่สร้าง source map ใน production) แล้วจึงเป็นเครื่องที่มีหน่วยความจำมากกว่า: 16 GB หรือ 32 GB

Skipbox ให้ build ได้หน่วยความจำนั้นในราคาเหมาจ่าย: 16 GB และ 8 vCPU บน `runs-on: skipbox-8x16` ในราคา $79 ต่อเดือน 32 GB และ 16 vCPU บน `skipbox-16x32` ในราคา $149 บนเครื่องที่ Skipbox โฮสต์ให้บัญชีของคุณเท่านั้น `.next/cache` อยู่ต่อให้ build ถัดไป แคชแพ็กเกจอยู่บนดิสก์ และสิ่งที่ `actions/cache` บันทึกถูกอ่านในเครื่อง ไม่จำกัดนาที

- `.next/cache` อยู่ต่อบนเครื่องเฉพาะของคุณ: build ถัดไปใช้การคอมไพล์ครั้งล่าสุดซ้ำ ไม่ต้องมีขั้นตอนแคช
- 16 GB ในราคา $79 ต่อเดือน หรือ 32 GB ในราคา $149 เทียบกับ 8 GB บน `ubuntu-latest` ของรีโพสิทอรีส่วนตัว
- แคชแพ็กเกจอยู่บนเครื่องของคุณ และการกู้คืนแคชอ่านจากดิสก์ของมันแทนการดาวน์โหลด

**GitHub Actions ราคาเหมาจ่าย ไม่จำกัดนาที** Skipbox รันจ็อบ GitHub Actions บนเครื่องเฉพาะของคุณเอง: $39 ต่อเดือน ไม่ว่าจะรันกี่นาที layer ของ Docker และแคช dependency ยังอยู่ระหว่างจ็อบ จ็อบถัดไปจึงเริ่มได้ทันที

รันเนอร์ 4 vCPU, 20,000 นาทีต่อเดือน: GitHub $222 → Skipbox $39. ประหยัด $183 ทุกเดือน.

ย้ายได้ด้วยบรรทัดเดียว: `runs-on: skipbox`

[เริ่มทดลองใช้ฟรี 7 วัน](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-th)

## ช้า: .next/cache เริ่มต้นว่างเปล่า

[คู่มือการแคช build ใน CI ของ Next.js](https://nextjs.org/docs/app/guides/ci-build-caching) (ภาษาอังกฤษ) อธิบายว่า Next.js บันทึกแคชไว้ที่ `.next/cache` และใช้ร่วมกันระหว่าง build และ CI ที่ไม่เก็บมันไว้ระหว่าง build จะแสดงข้อผิดพลาด `No Cache Detected` ขั้นตอนสำหรับ GitHub Actions ของมัน:

```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 เปลี่ยนทุกครั้งที่ซอร์สเปลี่ยน แต่ละการรันจึงบันทึกรายการใหม่ ภายใน 10 GB ต่อรีโพสิทอรีของ GitHub ใน Turborepo ให้ตัด `.next/cache` ออกจาก `outputs` ของ task (`"!.next/cache/**"`) อย่างที่[คู่มือ GitHub Actions ของ Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions) (ภาษาอังกฤษ) ทำ

## หน่วยความจำหมด: ข้อผิดพลาดสองแบบที่ต่างกัน

| ใน log | อะไรหมด | ควรทำอะไร |
|---|---|---|
| `JavaScript heap out of memory` | ขีดจำกัด heap ของ Node เอง เครื่องยังมีหน่วยความจำเหลือ | เพิ่มมัน: `NODE_OPTIONS=--max-old-space-size=6144` ให้ต่ำกว่าหน่วยความจำของเครื่อง |
| `Process completed with exit code 137` | หน่วยความจำของเครื่อง: Linux หยุดโปรเซส | ใช้หน่วยความจำน้อยลง หรือใช้เครื่องที่มีมากกว่า |

การเพิ่ม heap จนเกินหน่วยความจำของเครื่องจะเปลี่ยนข้อผิดพลาดแรกเป็นข้อผิดพลาดที่สอง

## ใช้หน่วยความจำน้อยลง: การตั้งค่าของ Next.js เอง

จาก[คู่มือการใช้หน่วยความจำของ Next.js](https://nextjs.org/docs/app/guides/memory-usage) (ภาษาอังกฤษ):

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 ขึ้นไป) ลดหน่วยความจำสูงสุดของ webpack แลกกับการคอมไพล์ที่นานขึ้นเล็กน้อย
- **webpack build worker** รันการคอมไพล์ใน Node worker แยก ซึ่งลดหน่วยความจำ เปิดเป็นค่าเริ่มต้นตั้งแต่ v14.1.0 เว้นแต่คุณมี webpack config แบบกำหนดเอง ถ้ามี ให้ตั้ง `experimental.webpackBuildWorker: true`
- **ปิด source map:** `productionBrowserSourceMaps: false` และ `experimental.serverSourceMaps: false` ถ้า build หน่วยความจำหมดระหว่าง "Generating static pages" ให้ตั้ง `enablePrerenderSourceMaps: false` ด้วย
- **วัดผล:** `next build --experimental-debug-memory-usage` (v14.2.0 ขึ้นไป) แสดงการใช้ heap ตลอด build และเก็บ heap snapshot เมื่อใกล้ขีดจำกัด
- **การตรวจ type:** `typescript.ignoreBuildErrors: true` ข้ามการตรวจ type และหน่วยความจำของมัน และปล่อยให้ข้อผิดพลาดของ type เข้าไปใน build Next.js เตือนไม่ให้ทำ เว้นแต่มีขั้นตอนอื่นตรวจ type

## ใช้เครื่องที่มีหน่วยความจำมากกว่า

| รันเนอร์ | CPU และหน่วยความจำ | ใครใช้ได้ |
|---|---|---|
| GitHub `ubuntu-latest` รีโพสิทอรีส่วนตัว | 2 CPU, 8 GB | ทุกคน |
| GitHub `ubuntu-latest` รีโพสิทอรีสาธารณะ | 4 CPU, 16 GB | รีโพสิทอรีสาธารณะ |
| รันเนอร์ขนาดใหญ่ของ GitHub 4 หรือ 8 คอร์ | 16 GB หรือ 32 GB | องค์กรบน GitHub Team และ Enterprise Cloud คิดเงินรายนาที ([รันเนอร์ขนาดใหญ่](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | องค์กรและบัญชีส่วนตัว $79 ต่อเดือน |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | องค์กรและบัญชีส่วนตัว $149 ต่อเดือน |

ที่ 20,000 นาทีต่อเดือน รันเนอร์ 8 คอร์ของ GitHub คือ $422 และ Skipbox M คือ $79 ที่ 16 คอร์ $822 เทียบกับ $149 สำหรับ L ตัวเลขของ GitHub คือหลังหักการใช้งานที่ GitHub Team รวมให้แล้ว

## Skipbox ทำอะไรให้ build ของ Next.js

ทุกแพ็กเกจมาพร้อมเครื่องเฉพาะของบัญชีคุณ ที่เก็บไว้ระหว่างจ็อบ:

- **หน่วยความจำที่ build ต้องการ** ตามเลเบล: 16 GB บน M และ 32 GB บน L ตั้ง heap ให้ตรงกัน เช่น `--max-old-space-size=12288` บน M
- **แคชแพ็กเกจอยู่บนดิสก์:** `~/.npm` store ของ pnpm `~/.cache` ของแต่ละเครื่องมือ และเวอร์ชัน Node ที่ `setup-node` ติดตั้ง `npm ci` อ่านจากสิ่งเหล่านี้แทน registry
- **`.next/cache` อยู่ต่อให้จ็อบถัดไป** เครื่องเก็บโค้ดที่ checkout ไว้ระหว่างจ็อบ และ `.next/cache` ในนั้น ไม่ว่า monorepo จะวางไว้ลึกแค่ไหน (`apps/web/.next/cache`) `next build` ครั้งถัดไปเริ่มจากมัน โดยไม่ต้องมีขั้นตอนแคช และไม่มี `No Cache Detected` ส่วนที่เหลือของ `.next` และไฟล์ที่ไม่ถูก track อื่นในโค้ดที่ checkout ไว้จะถูกล้างหลังแต่ละจ็อบ
- **การกู้คืนของ `actions/cache` อ่านจากเครื่อง** สิ่งที่มันบันทึกอยู่ข้างเครื่อง มีพื้นที่มากกว่า 10 GB ต่อรีโพสิทอรีของ GitHub และการกู้คืนเป็นการอ่านในเครื่อง คงขั้นตอน `.next/cache` ไว้สำหรับจ็อบที่รันบน VM ใหม่ บนเครื่องเฉพาะของคุณ การกู้คืนไม่แตะแคชที่เก็บไว้
- **คอร์มากขึ้นในราคาเหมาจ่าย** การคอมไพล์และการสร้างหน้า static ใช้คอร์เหล่านั้น และไม่จำกัดนาที

| เลเบล | เครื่อง | แพ็กเกจ |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 ต่อเดือน |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 ต่อเดือน |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 ต่อเดือน |

## ย้ายมาแค่บรรทัดเดียว

```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` รันบนแพ็กเกจ M ช่วงทดลองรัน `runs-on: skipbox`

1. เข้าสู่ระบบ Skipbox ด้วย GitHub
2. ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
3. เปลี่ยน `runs-on` แล้ว push

## ความปลอดภัย

- เครื่องเป็นของบัญชีคุณเท่านั้น ไม่มีจ็อบของบริษัทอื่นรันบนเครื่องนี้
- หลังทุกจ็อบ ข้อมูลรับรองของรันเนอร์ โปรเซส และคอนเทนเนอร์จะถูกลบ รวมถึงข้อมูลรับรองของ git ในโค้ดที่ checkout เก็บไว้ และไฟล์ที่ไม่ถูก track ของมัน ยกเว้นแคชของ build อย่าง `.next/cache` การตั้งค่า **VM ใหม่ทุกจ็อบ** ให้แต่ละจ็อบได้เครื่องใหม่แทน
- โค้ดจากคนที่ไม่มีสิทธิ์เขียน (เช่น pull request จาก fork) รันบน VM ใหม่ที่อ่านแคชของคุณได้แต่แก้ไขไม่ได้

รายละเอียดอยู่ใน[วิธีแยกจ็อบออกจากกัน](https://docs.skipbox.dev/th/isolation)

## ลองกับ build ของ Next.js

ทดลองใช้ฟรี 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร ช่วงทดลองรัน `runs-on: skipbox` ด้วย 16 GB ซึ่งเป็นหน่วยความจำ 2× ของ `ubuntu-latest` บนรีโพสิทอรีส่วนตัว: ลองแคชและหน่วยความจำที่นั่น แล้วย้าย build ที่ต้องการมากกว่านั้นไปแพ็กเกจ L (`skipbox-16x32`, 32 GB)

## คำถามที่พบบ่อย

### ทำไม next build ถึงช้าใน GitHub Actions

ส่วนใหญ่เพราะ .next/cache เริ่มต้นว่างเปล่า Next.js บันทึก build cache ไว้ที่ .next/cache และใช้ซ้ำใน build ถัดไป แต่จ็อบบนรันเนอร์ที่ GitHub โฮสต์คือ VM ใหม่ ถ้าไม่มีขั้นตอนที่ส่ง .next/cache ต่อไป ทุก build จะเป็น build เย็น และ log เตือนว่า No Cache Detected เพิ่ม actions/cache สำหรับ .next/cache ที่ใช้ key จาก lockfile และไฟล์ซอร์สของคุณ เวลาที่เหลือคือการติดตั้งและการคอมไพล์บน 2 CPU

### build ของ Next.js ควรใช้รันเนอร์ขนาดเท่าไรใน GitHub Actions

หน่วยความจำพอสำหรับจุดสูงสุดของ build ubuntu-latest ของรีโพสิทอรีส่วนตัวมี 2 CPU และ 8 GB และ build ของ webpack การตรวจ type และ source map ของแอป Next.js ขนาดใหญ่อาจเกินนั้น รันเนอร์ขนาดใหญ่ของ GitHub มี 16 GB ที่ 4 คอร์ และ 32 GB ที่ 8 คอร์ ใช้ได้เฉพาะบน GitHub Team หรือ Enterprise Cloud คิดเงินรายนาที Skipbox ให้ 16 GB กับ 8 vCPU บน runs-on: skipbox-8x16 ในราคา $79 ต่อเดือน และ 32 GB กับ 16 vCPU บน skipbox-16x32 ในราคา $149

### จะแก้ JavaScript heap out of memory ใน build ของ Next.js บน GitHub Actions อย่างไร

ข้อผิดพลาดนั้นคือขีดจำกัด heap ของ Node เอง ไม่ใช่หน่วยความจำของเครื่อง เพิ่มมันด้วย NODE_OPTIONS=--max-old-space-size=<MiB> โดยตั้งให้ต่ำกว่าหน่วยความจำของเครื่อง ถ้าจ็อบกลับจบด้วย exit code 137 แทน แปลว่าเครื่องเองหน่วยความจำหมด: ลดหน่วยความจำของ build (experimental.webpackMemoryOptimizations ไม่สร้าง source map ใน production) หรือรันบนเครื่องที่มีหน่วยความจำมากกว่า

### จะลดการใช้หน่วยความจำของ build Next.js อย่างไร

จากคู่มือหน่วยความจำของ Next.js: ลอง experimental.webpackMemoryOptimizations (v15 ขึ้นไป) เปิด webpack build worker ไว้ (เป็นค่าเริ่มต้นตั้งแต่ v14.1.0 ถ้าไม่มี webpack config แบบกำหนดเอง) ปิด productionBrowserSourceMaps และ experimental.serverSourceMaps และวัดด้วย next build --experimental-debug-memory-usage การข้ามการตรวจ type ด้วย typescript.ignoreBuildErrors ประหยัดหน่วยความจำแต่ปล่อยให้ข้อผิดพลาดของ type ผ่านไป จึงควรทำเฉพาะเมื่อมีจ็อบ CI อื่นตรวจ type

### Skipbox เก็บ .next/cache ไว้ระหว่างจ็อบไหม

เก็บ เครื่องเฉพาะของคุณเก็บโค้ดที่ checkout ไว้ระหว่างจ็อบ และ .next/cache ในนั้นด้วย ไม่ว่า Next.js จะวางไว้ที่ไหน (apps/web/.next/cache ใน monorepo) next build ครั้งถัดไปจึงเริ่มจากแคชของครั้งล่าสุดโดยไม่ต้องมีขั้นตอนแคช ส่วนที่เหลือของ .next และไฟล์ที่ไม่ถูก track อื่นในโค้ดที่ checkout ไว้จะถูกล้างหลังแต่ละจ็อบ แคชของ npm หรือ pnpm เวอร์ชัน Node ที่ setup-node ติดตั้ง และ layer ของ Docker ก็อยู่บนดิสก์เช่นกัน ขั้นตอน actions/cache สำหรับ .next/cache คงไว้ได้: จ็อบบน VM ใหม่ เช่น pull request จาก fork กู้คืนจากมัน และบนเครื่องเฉพาะของคุณ การกู้คืนไม่แตะแคชที่เก็บไว้

### ลองใช้มีค่าใช้จ่ายเท่าไร

ไม่เสียเลย ทดลองใช้ได้ 7 วัน หรือ 3,000 นาทีของจ็อบ แล้วแต่อย่างไหนครบก่อน ไม่ต้องใช้บัตร บน 4 vCPU และ 16 GB: 2× ของ 8 GB ใน ubuntu-latest บนรีโพสิทอรีส่วนตัว และเท่ากับรันเนอร์ขนาดใหญ่ 4 คอร์ของ GitHub ลองการแคชและหน่วยความจำที่นั่น สำหรับ build ที่ต้องการมากกว่านั้น เลือกแพ็กเกจ L แล้วเปลี่ยนเลเบลเป็น skipbox-16x32 (32 GB)

อัปเดต 2026-11-19 · https://skipbox.dev/th/guides/nextjs-build-slow-out-of-memory-github-actions
