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

خطأ 500 من دالة serverless

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

ما قد تراه

تظهر الصفحة أو الإجراء 500 Internal Server Error في الموقع الحي فقط
يعرض المتصفح FUNCTION_INVOCATION_FAILED

السبب الأرجح

تُطلق شيفرة الخادم خطأً تخفيه الصفحة عن الزوار؛ والرسالة الحقيقية في سجلات الدالة.

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

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

أمر الإصلاح

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

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

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

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

لغة الأمر

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

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

المشكلة
خطأ 500 من دالة serverless

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

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

السبب الأرجح
تُطلق شيفرة الخادم خطأً تخفيه الصفحة عن الزوار؛ والرسالة الحقيقية في سجلات الدالة.

نفّذ هذه الخطوات بهذا الترتيب
1. اطلب مني رسالة الخطأ وأسطر التتبع من سجلات الدالة (بعد إزالة الأسرار).
2. اعثر على السطر الذي يطلق الخطأ وما يحتاجه (متغير ناقص أو استدعاء قاعدة بيانات فاشل أو بيانات فارغة).
3. أصلح السبب واجعل الشيفرة تتعامل مع الفشل برسالة واضحة بدل الانهيار.
4. أعد النشر واختبر المسار الفاشل.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يرد المسار بـ 200 ولا تظهر أخطاء جديدة في سجلات الدالة.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

اطلب مني رسالة الخطأ وأسطر التتبع من سجلات الدالة (بعد إزالة الأسرار).
اعثر على السطر الذي يطلق الخطأ وما يحتاجه (متغير ناقص أو استدعاء قاعدة بيانات فاشل أو بيانات فارغة).
أصلح السبب واجعل الشيفرة تتعامل مع الفشل برسالة واضحة بدل الانهيار.
أعد النشر واختبر المسار الفاشل.

لا تفعل هذا

لا تخمّن دون قراءة السجل.
لا تعرض تفاصيل الأخطاء الخام للزوار.