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

انتهاء مهلة الدالة (504) على Vercel

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

ما قد تراه

إجراء يدور ثم يفشل بعد 10 ثوانٍ أو أكثر
تظهر 504 أو FUNCTION_INVOCATION_TIMEOUT

السبب الأرجح

تستغرق شيفرة الخادم وقتاً أطول مما يسمح به Vercel لطلب واحد، وغالباً بسبب استدعاء بطيء لقاعدة البيانات أو لخدمة خارجية أو عمل يجب أن يتم في الخلفية.

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

في مشروع Vercel افتح سجلات الدالة وقت الفشل وابحث عن اسم المسار.
قس زمن الإجراء نفسه محلياً: هل هو بطيء هناك أيضاً؟

أمر الإصلاح

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

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

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

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

لغة الأمر

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

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

المشكلة
انتهاء مهلة الدالة (504) على Vercel

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

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

السبب الأرجح
تستغرق شيفرة الخادم وقتاً أطول مما يسمح به Vercel لطلب واحد، وغالباً بسبب استدعاء بطيء لقاعدة البيانات أو لخدمة خارجية أو عمل يجب أن يتم في الخلفية.

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

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

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

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

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

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

الخطوات

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

لا تفعل هذا

لا تعِد المحاولة في حلقة لا تنتهي: يزيد ذلك الحمل.
لا ترفع الحدود لكل المسارات.