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 (ภาษาอังกฤษ) ทำ
หน่วยความจำหมด: ข้อผิดพลาดสองแบบที่ต่างกัน
| ใน 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 (ภาษาอังกฤษ):
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 คิดเงินรายนาที (รันเนอร์ขนาดใหญ่) |
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 - แคชแพ็กเกจอยู่บนดิสก์:
~/.npmstore ของ 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 ต่อเดือน |
ย้ายมาแค่บรรทัดเดียว
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
- เข้าสู่ระบบ Skipbox ด้วย GitHub
- ติดตั้ง GitHub App ของ Skipbox แล้วเลือกรีโพสิทอรี
- เปลี่ยน
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