# بناء Next.js بطيء أو تنفد ذاكرته في GitHub Actions: ذاكرة التخزين المؤقت، والذاكرة، وحجم المشغّل

> يبطؤ بناء Next.js في GitHub Actions حين لا يُنقل .next/cache إلى التشغيل التالي، وتنفد ذاكرته على ubuntu-latest بذاكرة 8 GB في مستودع خاص حين تجتمع webpack وفحص الأنواع وخرائط المصدر. ما الذي تخزّنه مؤقتًا، وأي إعدادات Next.js تخفّض الذاكرة، وحجم المشغّل: 16 GB مقابل $79 شهريًا أو 32 GB مقابل $149 على Skipbox، حيث يبقى .next/cache بين المهام والدقائق غير محدودة.

يبطؤ بناء 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` يبقى على جهازك المخصّص: يعيد البناء التالي استخدام ترجمته السابقة، دون خطوة تخزين مؤقت
- 16 GB مقابل $79 شهريًا أو 32 GB مقابل $149، مقابل 8 GB في `ubuntu-latest` خاص
- ذاكرة الحزم المؤقتة تبقى على جهازك، واستعادات ذاكرة التخزين المؤقت تقرأ قرصه بدلًا من التنزيل

**GitHub Actions بسعر ثابت ودقائق غير محدودة** يشغّل Skipbox مهام GitHub Actions على جهاز مخصص لك وحدك: $39 شهريًا، مهما كان عدد الدقائق التي تشغّلها. تبقى طبقات Docker وذاكرة التخزين المؤقت للتبعيات بين المهام، فتبدأ المهمة التالية فورًا.

مشغّل بـ 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-ar)

## البطء: .next/cache يبدأ فارغًا

من [دليل التخزين المؤقت لبناء CI](https://nextjs.org/docs/app/guides/ci-build-caching) في Next.js: يحفظ Next.js ذاكرة تخزين مؤقت في `.next/cache` تتشاركها عمليات البناء، وأي CI لا يحفظها بين عمليات البناء يُظهر خطأ `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') }}-
```

يتغير المفتاح مع كل تغيير في الكود المصدري، فيحفظ كل تشغيل إدخالًا جديدًا، داخل 10 GB التي يمنحها GitHub لكل مستودع. وفي Turborepo، استبعد `.next/cache` من `outputs` الخاصة بالمهمة (`"!.next/cache/**"`)، كما يفعل [دليل GitHub Actions في Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions).

## نفاد الذاكرة: خطآن مختلفان

| في السجل | ما الذي نفد | ما الذي تفعله |
|---|---|---|
| `JavaScript heap out of memory` | حد الكومة الخاص بـ Node؛ وما زال في الجهاز ذاكرة | ارفعه: `NODE_OPTIONS=--max-old-space-size=6144`، بقيمة أدنى من ذاكرة الجهاز |
| `Process completed with exit code 137` | ذاكرة الجهاز: قتل Linux العملية | استهلك ذاكرة أقل، أو استخدم جهازًا بذاكرة أكبر |

ورفع الكومة فوق ذاكرة الجهاز يحوّل الخطأ الأول إلى الثاني.

## استهلك ذاكرة أقل: إعدادات Next.js نفسها

من [دليل استهلاك الذاكرة](https://nextjs.org/docs/app/guides/memory-usage) في 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](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 دقيقة شهريًا، يبلغ مشغّل 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 شهريًا |

## الانتقال سطر واحد

```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. ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
3. غيّر `runs-on` ثم ادفع التغيير.

## الأمان

- الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
- بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته، وكذلك بيانات اعتماد git في نسخة الكود المحفوظة وملفاتها غير المتتبَّعة، عدا ذاكرات البناء المؤقتة مثل `.next/cache`. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك.
- الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز افتراضي جديد يقرأ ذاكرتك المؤقتة لكنه لا يستطيع تغييرها.

التفاصيل في [كيف تُعزل المهام](https://docs.skipbox.dev/ar/isolation).

## جرّبه على بناء 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).

آخر تحديث: 2026-11-19 · https://skipbox.dev/ar/guides/nextjs-build-slow-out-of-memory-github-actions
