رموز الأخطاء

عندما يفشل نشرٌ لسبب معروف، تُنهي غيمة سجل النشر برمز مثل [GH-OOM] وتعرض الرمز نفسه في لوحة «سبب الفشل» الخاصة بالنشر. للرمز المعنى نفسه دائمًا، لذا يمكنك البحث عنه أو ذكره في تذكرة الدعم.

GH-PLATFORM · هذا الفشل من جهتنا، وليس من تطبيقك.#

السبب

واجه البناء خطأ داخليًا في المنصة. لا دخل لمستودعك ولا لإعداداتك في ذلك.

الإصلاح

أعد المحاولة. إن تكرّر الفشل بنفس الشكل، افتح تذكرة دعم واذكر هذا النشر — فريقنا لديه التفاصيل بالفعل.

GH-OOM · نفدت الذاكرة من العملية فتم إيقافها.#

السبب

أُوقفت بالرمز 137 — بلغت الحاوية حدّ الذاكرة، وليس انهيارًا في شيفرتك.

الإصلاح

ارفع الذاكرة من الإعدادات ← الموارد (حتى سقف باقتك). وإن كان البناء نفسه هو ما ينفد، قلّل ما يحمّله دفعة واحدة — عدد أقل من العمليات المتوازية، وخطوة حزم أصغر.

GH-REPO-SIZE · المستودع أكبر من أن يُبنى.#

السبب

تجاوز الاستنساخ حدّ مساحة البناء قبل أن يبدأ البناء. عادةً بسبب مخرجات بناء مُودعة في git، أو تبعيات مُضمّنة، أو ملفات ثنائية كبيرة في تاريخ المستودع.

الإصلاح

أضف مجلدات البناء والتبعيات إلى .gitignore، وانقل الملفات الكبيرة إلى تخزين الكائنات، وحدّد مجلدًا جذرًا من الإعدادات ← البناء والتشغيل إن كان مجلد فرعي واحد هو ما يُبنى.

GH-NO-START · لا شيء يخبر المنصة كيف تُشغّل تطبيقك.#

السبب

تم بناء الصورة، لكن لم يُعثر على أمر تشغيل — لا سكربت `start` في ملفك ولا أمر مُعدّ على الخدمة.

الإصلاح

حدّد أمر التشغيل من الإعدادات ← البناء والتشغيل (مثل `node dist/server.js`)، أو أضف سكربت `start` إلى package.json. وتأكّد أنه يستمع على المنفذ المُعدّ لهذه الخدمة.

GH-NPM-ERESOLVE · هناك تعارض بين تبعياتك ورفض npm تثبيتها.#

السبب

واجه npm تعارض ERESOLVE في التبعيات النظيرة: حزمتان تطلبان نسختين متعارضتين من التبعية نفسها.

الإصلاح

أعد إنتاج المشكلة محليًا بتثبيت نظيف عبر `npm install` (احذف node_modules وpackage-lock.json أولًا)، وأصلح تعارض النسخ الذي يُبلغ عنه، ثم أودع ملف القفل المحدَّث. لا تُخفِ المشكلة بـ --force.

GH-PRERENDER-ENV · شغّل إطار العمل شيفرتك أثناء البناء، بدون بيئة.#

السبب

فشل البناء أثناء التصيير المسبق للصفحات. متغيرات بيئة التشغيل غير متاحة أثناء البناء ما لم تكشفها، فكل قراءة من قاعدة بيانات أو واجهة برمجية وقت البناء تحصل على لا شيء.

الإصلاح

افتح البيئة ← متغيرات البناء واكشف فقط المفاتيح التي يحتاجها البناء (اللوحة تقترحها عليك). أو انقل جلب البيانات إلى وقت الطلب حيث تتوفر بيئة التشغيل كاملة.