بناء Next.js بطيء أو تنفد ذاكرته في GitHub Actions: ذاكرة التخزين المؤقت، والذاكرة، وحجم المشغّل
يبطؤ بناء Next.js في GitHub Actions لسبب، وتنفد ذاكرته لسبب آخر. يبطؤ حين لا يُنقل .next/cache إلى التشغيل التالي: يعيد Next.js استخدام تلك الذاكرة بين عمليات البناء، والمهمة المستضافة على GitHub تبدأ على جهاز افتراضي جديد، وبدون خطوة تخزين مؤقت يكون كل بناء باردًا (يقول السجل No Cache Detected). وتنفد ذاكرته لأن في ubuntu-latest على مستودع خاص 8 GB، وترجمة webpack لتطبيق كبير مع فحص الأنواع وخرائط المصدر قد تتجاوز ذلك. أصلح الأول بـ actions/cache على .next/cache. وللثاني، تأتي إعدادات الذاكرة في Next.js أولًا (experimental.webpackMemoryOptimizations، وبلا خرائط مصدر في الإنتاج)؛ ثم جهاز بذاكرة أكبر: 16 GB أو 32 GB.
يمنح Skipbox البناء تلك الذاكرة بسعر ثابت: 16 GB و8 vCPU على runs-on: skipbox-8x16 مقابل $79 شهريًا، و32 GB و16 vCPU على skipbox-16x32 مقابل $149. وعلى جهاز يستضيفه Skipbox لحسابك وحده يبقى .next/cache للبناء التالي، وتبقى ذاكرة الحزم المؤقتة على القرص، وما يحفظه actions/cache يُقرأ محليًا، مع دقائق غير محدودة.
البطء: .next/cache يبدأ فارغًا
من دليل التخزين المؤقت لبناء CI في Next.js: يحفظ Next.js ذاكرة تخزين مؤقت في .next/cache تتشاركها عمليات البناء، وأي CI لا يحفظها بين عمليات البناء يُظهر خطأ 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') }}-
يتغير المفتاح مع كل تغيير في الكود المصدري، فيحفظ كل تشغيل إدخالًا جديدًا، داخل 10 GB التي يمنحها GitHub لكل مستودع. وفي Turborepo، استبعد .next/cache من outputs الخاصة بالمهمة ("!.next/cache/**")، كما يفعل دليل GitHub Actions في Turborepo.
نفاد الذاكرة: خطآن مختلفان
| في السجل | ما الذي نفد | ما الذي تفعله |
|---|---|---|
JavaScript heap out of memory | حد الكومة الخاص بـ Node؛ وما زال في الجهاز ذاكرة | ارفعه: NODE_OPTIONS=--max-old-space-size=6144، بقيمة أدنى من ذاكرة الجهاز |
Process completed with exit code 137 | ذاكرة الجهاز: قتل Linux العملية | استهلك ذاكرة أقل، أو استخدم جهازًا بذاكرة أكبر |
ورفع الكومة فوق ذاكرة الجهاز يحوّل الخطأ الأول إلى الثاني.
استهلك ذاكرة أقل: إعدادات Next.js نفسها
من دليل استهلاك الذاكرة في Next.js:
experimental.webpackMemoryOptimizations: true(v15.0.0 وما بعده) يخفض ذروة ذاكرة webpack، مقابل ترجمة أطول قليلًا.- عامل بناء webpack يشغّل الترجمة في عامل Node منفصل، ما يخفض الذاكرة. وهو مفعّل افتراضيًا منذ v14.1.0 ما لم يكن لديك إعداد webpack مخصص؛ ومعه، اضبط
experimental.webpackBuildWorker: true. - إيقاف خرائط المصدر:
productionBrowserSourceMaps: falseوexperimental.serverSourceMaps: false. وإن نفدت ذاكرة البناء أثناء «Generating static pages»، فـenablePrerenderSourceMaps: falseأيضًا. - القياس:
next build --experimental-debug-memory-usage(v14.2.0 وما بعده) يطبع استهلاك الكومة طوال البناء، ويلتقط لقطات للكومة قرب الحد. - فحص الأنواع:
typescript.ignoreBuildErrors: trueيتخطى فحص الأنواع وذاكرته، ويُدخل أخطاء الأنواع إلى البناء. ويحذّر Next.js منه ما لم تفحص خطوة أخرى الأنواع.
استخدم جهازًا بذاكرة أكبر
| المشغّل | المعالج والذاكرة | من يستطيع استخدامه |
|---|---|---|
ubuntu-latest في GitHub، مستودع خاص | 2 CPU، 8 GB | الجميع |
ubuntu-latest في GitHub، مستودع عام | 4 CPU، 16 GB | المستودعات العامة |
| مشغّل GitHub أكبر، 4 أو 8 أنوية | 16 GB أو 32 GB | مؤسسات GitHub Team وEnterprise Cloud، بالدقيقة (larger runners) |
Skipbox skipbox-8x16 | 8 vCPU، 16 GB | المؤسسات والحسابات الشخصية، $79 شهريًا |
Skipbox skipbox-16x32 | 16 vCPU، 32 GB | المؤسسات والحسابات الشخصية، $149 شهريًا |
عند 20,000 دقيقة شهريًا، يبلغ مشغّل GitHub ذو 8 أنوية $422 وSkipbox M $79؛ وعلى 16 نواة، $822 مقابل $149 لـ L. وأرقام GitHub بعد الاستخدام المضمّن في GitHub Team.
ما يفعله Skipbox لبناء Next.js
تأتي كل خطة مع جهاز خاص بحسابك، محفوظ بين المهام:
- الذاكرة التي يحتاجها البناء، بالتسمية: 16 GB على M، و32 GB على L. اضبط الكومة بما يناسبها، مثل
--max-old-space-size=12288على M. - ذاكرة الحزم المؤقتة تبقى على القرص:
~/.npm، ومخزن pnpm، و~/.cacheلكل أداة، وإصدارات Node التي ثبّتهاsetup-node. فيقرؤهاnpm ciبدلًا من السجل. .next/cacheيبقى للمهمة التالية. يحتفظ الجهاز بنسخة الكود المسحوبة بين المهام، ومعها.next/cacheمهما كان عمقه في المستودع الأحادي (apps/web/.next/cache). ويبدأnext buildالتالي منه، دون خطوة تخزين مؤقت ودونNo Cache Detected. ويُنظَّف باقي.nextوسائر الملفات غير المتتبَّعة في نسخة الكود المسحوبة بعد كل مهمة.- استعادات
actions/cacheتقرأ الجهاز. ما تحفظه خطوة التخزين المؤقت يبقى بجوار الجهاز، بمساحة أكبر من 10 GB التي يمنحها GitHub لكل مستودع، والاستعادة قراءة محلية. أبقِ خطوة.next/cacheللمهام التي تعمل على جهاز افتراضي جديد؛ أما على جهازك المخصّص فتترك الاستعادة الذاكرة المحفوظة كما هي. - أنوية أكثر بسعر ثابت. تستخدمها الترجمة وتوليد الصفحات الثابتة، والدقائق غير محدودة.
| التسمية | الجهاز | الخطة |
|---|---|---|
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.
- ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
- غيّر
runs-onثم ادفع التغيير.
الأمان
- الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
- بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته، وكذلك بيانات اعتماد git في نسخة الكود المحفوظة وملفاتها غير المتتبَّعة، عدا ذاكرات البناء المؤقتة مثل
.next/cache. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك. - الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز افتراضي جديد يقرأ ذاكرتك المؤقتة لكنه لا يستطيع تغييرها.
التفاصيل في كيف تُعزل المهام.
جرّبه على بناء Next.js
الفترة التجريبية مجانية لمدة 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة. وتشغّل runs-on: skipbox، بذاكرة 16 GB، أي 2× ذاكرة ubuntu-latest على مستودع خاص: جرّب ذاكرة التخزين المؤقت والذاكرة هناك، وانقل البناء الذي يحتاج إلى المزيد إلى الخطة L (skipbox-16x32، 32 GB).
الأسئلة الشائعة
لماذا يبطؤ next build في GitHub Actions؟
في الغالب لأن .next/cache يبدأ فارغًا. يحفظ Next.js ذاكرة بناء مؤقتة في .next/cache ويعيد استخدامها في البناء التالي، لكن المهمة المستضافة على GitHub جهاز افتراضي جديد، فبدون خطوة تنقل .next/cache يكون كل بناء باردًا ويحذّر السجل بـ No Cache Detected. أضف actions/cache لـ .next/cache بمفتاح على ملف القفل وملفات الكود المصدري. وباقي الوقت هو التثبيت والترجمة على 2 CPU.
ما حجم المشغّل الذي ينبغي أن يستخدمه بناء Next.js في GitHub Actions؟
ذاكرة تكفي لذروة البناء. في ubuntu-latest على مستودع خاص 2 CPU و8 GB، وبناء webpack لتطبيق 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 في بناء Next.js على GitHub Actions؟
ذلك الخطأ هو حد الكومة الخاص بـ Node، لا ذاكرة الجهاز. ارفعه بـ NODE_OPTIONS=--max-old-space-size=<MiB>، بقيمة أدنى من ذاكرة الجهاز. وإن انتهت المهمة بعد ذلك برمز الخروج 137 بدلًا منه، فقد نفدت ذاكرة الجهاز نفسه: خفّض ذاكرة البناء (experimental.webpackMemoryOptimizations، وبلا خرائط مصدر في الإنتاج) أو شغّل على جهاز بذاكرة أكبر.
كيف أخفّض استهلاك الذاكرة في بناء Next.js؟
من دليل الذاكرة في Next.js: جرّب experimental.webpackMemoryOptimizations (v15 وما بعده)، وأبقِ عامل بناء webpack مفعّلًا (الافتراضي دون إعداد webpack مخصص منذ v14.1.0)، وأوقف productionBrowserSourceMaps وexperimental.serverSourceMaps، وقِس بـ next build --experimental-debug-memory-usage. وتخطي فحص الأنواع بـ typescript.ignoreBuildErrors يوفّر الذاكرة لكنه يُمرّر أخطاء الأنواع، فلا تفعله إلا حين تفحص مهمة CI أخرى الأنواع.
هل يحتفظ Skipbox بـ .next/cache بين المهام؟
نعم. يحتفظ جهازك المخصّص بنسخة الكود المسحوبة بين المهام، ومعها .next/cache أينما وضعه Next.js (apps/web/.next/cache في المستودع الأحادي)، فيبدأ next build التالي من ذاكرة البناء السابق المؤقتة دون أي خطوة تخزين مؤقت. ويُنظَّف باقي .next وسائر الملفات غير المتتبَّعة في نسخة الكود المسحوبة بعد كل مهمة. وذاكرة npm أو pnpm المؤقتة، وإصدارات Node التي ثبّتها setup-node، وطبقات Docker تبقى على القرص أيضًا. ويمكن إبقاء خطوة actions/cache الخاصة بـ .next/cache: فالمهمة التي تعمل على جهاز افتراضي جديد، مثل طلب سحب من نسخة متفرعة، تستعيد منها، وعلى جهازك المخصّص تترك الاستعادة الذاكرة المحفوظة كما هي.
كم تكلّف التجربة؟
لا شيء. الفترة التجريبية 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة، على 4 vCPU و16 GB: 2× الـ 8 GB في ubuntu-latest على مستودع خاص، وهي الذاكرة نفسها في مشغّل GitHub الأكبر ذي 4 أنوية. جرّب التخزين المؤقت والذاكرة هناك؛ وللبناء الذي يحتاج إلى المزيد، اختر الخطة L وغيّر التسمية إلى skipbox-16x32 (32 GB).
آخر تحديث: 19 نوفمبر 2026