إصلاح · فيرسل والنشر

فشل البناء (build) على Vercel

تعطّل عملكلم يُفحص مقابل شاشات الجهة الحالية

ما قد تراه

يظهر النشر بحالة Error أو Build failed بالأحمر
يعمل على جهازي ولا يعمل على Vercel
لم يتحدّث موقعي بعد أن دفعت التغييرات

السبب الأرجح

يتوقف أمر البناء عند خطأ واحد لا يظهر على جهازك، وغالباً يكون متغيراً ناقصاً أو إصداراً مختلفاً أو خطأ أنواع (types).

افحص أولاً (نحو دقيقتين)

افتح النشر الفاشل وسجل البناء؛ وانزل إلى أول سطر أحمر وليس الأخير.
شغّل أمر البناء نفسه (npm run build) على جهازك.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

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

أسماء القوائم والأزرار تتغير مع الوقت. إذا لم تجد زراً أو صفحة أذكرها فقل ذلك وأخبرني عمّا أبحث بدلاً من التخمين.

المشكلة
فشل البناء (build) على Vercel

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
يتوقف أمر البناء عند خطأ واحد لا يظهر على جهازك، وغالباً يكون متغيراً ناقصاً أو إصداراً مختلفاً أو خطأ أنواع (types).

نفّذ هذه الخطوات بهذا الترتيب
1. اطلب مني لصق أول أسطر الخطأ من سجل البناء (دون أسرار).
2. شغّل npm run build محلياً وقارن: إن فشل أيضاً فأصلح ذلك الخطأ أولاً، وإن نجح فقارن إصدار Node والمتغيرات مع إعدادات مشروع Vercel.
3. أصلح سبب أول خطأ فقط. لا "تصلح" الأخطاء اللاحقة قبل زوال الأول.
4. ادفع واقرأ سجل البناء الجديد.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يصبح النشر Ready ويعرض عنوان الإنتاج التغيير.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا توقف فحص الأنواع أو قواعد lint لمجرد تمرير البناء.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

اطلب مني لصق أول أسطر الخطأ من سجل البناء (دون أسرار).
شغّل npm run build محلياً وقارن: إن فشل أيضاً فأصلح ذلك الخطأ أولاً، وإن نجح فقارن إصدار Node والمتغيرات مع إعدادات مشروع Vercel.
أصلح سبب أول خطأ فقط. لا "تصلح" الأخطاء اللاحقة قبل زوال الأول.
ادفع واقرأ سجل البناء الجديد.

لا تفعل هذا

لا تعِد النشر عشر مرات على أمل أن يتغير: اقرأ السجل.
لا توقف فحص الأنواع أو قواعد lint لمجرد تمرير البناء.