Skipbox

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

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 ใน CI ของ Next.js (ภาษาอังกฤษ) อธิบายว่า Next.js บันทึกแคชไว้ที่ .next/cache และใช้ร่วมกันระหว่าง build และ CI ที่ไม่เก็บมันไว้ระหว่าง build จะแสดงข้อผิดพลาด No Cache Detected ขั้นตอนสำหรับ GitHub Actions ของมัน:

- 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 (ภาษาอังกฤษ) ทำ

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

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

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

จากคู่มือการใช้หน่วยความจำของ Next.js (ภาษาอังกฤษ):

  • 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

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

ที่ 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 ใช้คอร์เหล่านั้น และไม่จำกัดนาที

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

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 ใหม่ที่อ่านแคชของคุณได้แต่แก้ไขไม่ได้

รายละเอียดอยู่ในวิธีแยกจ็อบออกจากกัน

ลองกับ 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)

อัปเดต 19 พฤศจิกายน 2026

CI/CD ที่เร็วขึ้นด้วยแคชที่พร้อมเสมอ

รันเนอร์ที่พร้อมทำงานเสมอ ในราคาเหมาจ่าย

เราโฮสต์ให้ คุณแก้แค่บรรทัดเดียว ค่าใช้จ่ายเพียง 1/12 ของ GitHub เมื่อใช้เต็มที่ ราคาเหมาจ่าย จึงรันได้ทั้งวัน พื้นที่แคช 7 เท่าของ GitHub

  • ไม่ต้องใช้บัตร
  • เข้าสู่ระบบด้วย GitHub
  • ยกเลิกได้ทุกเมื่อ