ماذا يقول 504 فعليًا
البوابة (gateway) هي أي جهة تستقبل طلبًا وتمرّره: حافة CDN، أو موازن تحميل، أو nginx أمام PHP-FPM أو Node. 504 Gateway Timeout هو قول البوابة: وصلتُ إلى الخادم الذي خلفي، وسألته، ولم تأتِ الإجابة قبل حدّي.
وهذا ما يميّز 504 عن جيرانه. 502 Bad Gateway يعني أن الإجابة كانت غير صالحة أو أن الاتصال فشل. و503 Service Unavailable يعني أن شيئًا ردّ الطلب عمدًا. أما 504 فيعني أن أحدًا لم يرفض شيئًا — الطلب قُبل، وقد يكون ما زال يعمل على خادمك بعد أن عُرض الخطأ على الزائر.
وهذه النقطة الأخيرة مهمة عمليًا. الخطأ 504 لا يلغي العمل: تقرير انتهت مهلته عند الوسيط قد يكتمل على الأصل بعد دقيقة، والزائر الذي يضغط الزر مرة أخرى يبدأ نسخة ثانية.
من انتظر من
يمرّ الطلب النموذجي بعدة محطات انتظار: الزائر ← حافة CDN ← خادم الويب (nginx أو Apache) ← تطبيقك (PHP-FPM أو Node أو حاوية) ← قاعدة البيانات أو API خارجي. كل سهم بوابة لها مهلتها الخاصة، وتُضبط كل مهلة على حدة، وغالبًا على يد أشخاص مختلفين.
القاعدة التي توفّر أكبر وقت: أقصر مهلة في السلسلة هي التي تنطلق. إن كانت الحافة تنتظر 60 ثانية، وnginx لديك ينتظر PHP-FPM 60 ثانية، وPHP يوقف السكربت بعد 30، فلن يقترب الطلب أبدًا من حد الحافة — تنهيه PHP عند 30 ثانية وتبلّغ المحطة التي فوقها عن الفشل.
لذلك فالسؤال الأول ليس "لماذا ينتهي CDN بمهلة" بل كم استغرق الأمر قبل ظهور الخطأ؟ الخطأ 504 الذي يظهر عند 60 ثانية بالضبط يشير إلى حد 60 ثانية، وعند 30 ثانية إلى حد 30 ثانية. قارن هذا الرقم بالحدود التي تعرفها، وغالبًا ما تكشف المحطة التي استسلمت نفسها.
الأسباب وراء كل 504 تقريبًا
استعلام بطيء. استعلام واحد بلا الفهرس المناسب، يمسح جدولًا نما من عشرة آلاف صف إلى عشرة ملايين. كان سريعًا عند الإطلاق وهو بطيء اليوم، ولم يتغير شيء في الشيفرة.
عمل طويل بطبيعته. تصدير CSV وExcel، وتقارير PDF، والاستيراد الجماعي، ومعالجة الصور أو الفيديو، ونسخ احتياطي يبدأ من صفحة الإدارة. هذه ليست أخطاء؛ إنها مهام لا ينبغي أن تعمل داخل طلب ويب.
استدعاء خارجي بلا مهلة. مزوّد دفع، أو API شحن، أو خدمة بحث. حين يعلق، يعلق طلبك معه، ويدفع زوّارك ثمن انقطاع غيرك.
أصل مثقل. حين يكون كل عامل PHP-FPM أو خيط مشغولًا، تنتظر الطلبات الجديدة في قائمة قبل أن تبدأ أصلًا. قد يكون كل طلب سريعًا؛ الانتظار في الطابور هو ما يستهلك الوقت. تتجمع حالات 504 هذه عند ذروات الزيارات.
مشكلة شبكة بين المحطات. جدار حماية يُسقط الحزم بصمت بدل أن يرفضها يجعل الوسيط ينتظر اتصالًا لن يُفتح أبدًا. والنتيجة 504 بدل فشل سريع.
شخّص المشكلة: قِس أين يذهب الوقت
قِس زمن الطلب عبر CDN، ثم الطلب نفسه مباشرةً إلى أصلك. يستطيع curl تقسيم الوقت إلى مراحل، كما في الأوامر أدناه.
إن كانت قيمة connect كبيرة أو لا تكتمل، فالمشكلة في الوصول إلى الأصل: جدار حماية، أو توجيه، أو خادم متوقف. وإن كانت connect سريعة وكانت ttfb (زمن أول بايت) طويلة، فقد قبل الأصل الطلب وما زال يعمل عليه — وهذا هو 504 الكلاسيكي، والجواب في تطبيقك.
الأمر الثاني يتجاوز CDN بالخيار --resolve ويرسل اسم مضيفك كما هو. إن استغرق الأصل وحده 70 ثانية أيضًا، فالحافة تنقل الحقيقة. وإن أجاب خلال ثانيتين مباشرةً وانتهت مهلته عبر CDN، فانظر إلى ما يختلف: قاعدة جدار حماية، أو خادم خلفي آخر لذلك الاسم، أو ترويسات يعاملها تطبيقك بشكل مختلف.
ثم اقرأ سجلات الأصل نفسه في تلك اللحظة. في nginx أضف $request_time و$upstream_response_time إلى تنسيق السجل؛ وفي Apache أضف %D. فعّل سجل الاستعلامات البطيئة في قاعدة بياناتك، وفي PHP فعّل slowlog الخاص بـ PHP-FPM الذي يكتب تتبّع المكدّس لكل طلب يطول أكثر من اللازم — وهو عادةً أسرع طريق إلى السطر المعني.
قياس زمن طلب عبر CDN ومباشرةً إلى الأصل
# through the CDN
curl -o /dev/null -s -w 'connect=%{time_connect}s tls=%{time_appconnect}s ttfb=%{time_starttransfer}s total=%{time_total}s code=%{http_code}\n' \
https://www.example.com/reports/export
# straight to the origin, same hostname
curl -o /dev/null -s -w 'connect=%{time_connect}s ttfb=%{time_starttransfer}s total=%{time_total}s code=%{http_code}\n' \
--resolve www.example.com:443:ORIGIN_IP https://www.example.com/reports/export
أصلح الجزء البطيء أولًا
رفع المهلة يُخفي الخطأ ويُبقي الزائر ينتظر المدة نفسها. قبل أن تلمس أي حد، اجعل الطلب أقصر.
الفهارس والتخزين المؤقت. اعثر على الاستعلام البطيء في سجل الاستعلامات البطيئة وأضف الفهرس الذي يحتاجه. خزّن مؤقتًا النتائج التي يتشاركها كثير من الزوار، في التطبيق أو عند الحافة عبر ترويسات Cache-Control.
انقل العمل الطويل خارج الطلب. حوّل التصدير إلى مهمة في الخلفية: النقرة تضع المهمة في الطابور وتعود فورًا، والصفحة تعرض التقدّم، والملف المكتمل يصل كرابط تنزيل أو بالبريد. يبقى طلب الويب قصيرًا مهما كبرت المهمة.
امنح كل استدعاء خارجي مهلته. بضع ثوانٍ مع بديل معقول، حتى لا يصبح انقطاع شركة أخرى انقطاعك.
قدّر حجم الأصل للذروة. إن كانت حالات 504 تتجمع في ساعات الازدحام، فأضف عمّالًا (pm.max_children في PHP-FPM، أو عمليات Node، أو نسخ الحاويات) ودع ذاكرة الحافة المؤقتة تمتص الطلبات المتكررة فيصل منها إلى الأصل عدد أقل.
ارفع المهلة حيث يلزم فقط
بعض الطلبات طويلة بطبيعتها: رفع كبير تجري معالجته، أو تقرير لا يمكن تقسيمه، أو API يبثّ النتائج. لهذه ارفع الحد — لذلك المسار وحده، وعند كل محطة.
في cdn.com.tr هذا إعداد في قاعدة التسليم: مهلة استجابة الخادم الأصلي (بالثواني)، من 1 إلى 3,600 ثانية لكل قاعدة، والافتراضي 60 ثانية. أنشئ قاعدة منفصلة للمسار الذي يحتاج ذلك، مثل /admin/export/، وامنح تلك القاعدة وحدها مهلة أطول. يحتفظ بقية الموقع بالافتراضي القصير ويظل يفشل سريعًا حين يكون هناك عطل فعلي. وعلى نطاق تطبيق Managed Container تكون المهلة الافتراضية 300 ثانية ما لم تحدد القاعدة قيمة أخرى.
تحتسب المهلة الزمن بين قطعتي بيانات من أصلك، لا إجمالي مدة الطلب. ما دامت البيانات تتدفق، تُبقي الحافة الطلب مفتوحًا. ولهذا يستطيع رد متدفق — ملف CSV يُكتب صفًا بصف، أو بثّ تقدّم — أن يستمر دقائق طويلة، بينما لا يستطيع ذلك سكربت يحسب خمس دقائق ثم يطبع كل شيء دفعة واحدة.
بعد ذلك اضبط المحطات خلف الحافة: proxy_read_timeout أو fastcgi_read_timeout في nginx، وmax_execution_time في PHP، وحد خادم تطبيقك نفسه. طول المسار لا يتجاوز أقصر حد فيه.
حين يكون CDN أمامك
يغيّر CDN كلفة الخطأ 504 عليك.
الصفحات المخزّنة تستمر في الخدمة. في قاعدة تخزّن مؤقتًا، إن انتهت مهلة أصلك بينما ما زالت الحافة تحتفظ بنسخة من الصفحة — حتى لو منتهية الصلاحية — تقدّم الحافة تلك النسخة بدل الخطأ. دقيقة بطيئة على الأصل تصبح صفحة قديمة قليلًا لا صفحة معطوبة. وهذا سبب وجيه لتخزين كل ما يمكن تخزينه مؤقتًا، بمُدد صلاحية (TTL) تناسب معدل تغيّر المحتوى فعلًا.
تظهر المسارات البطيئة. حين تظهر حالات 504 على /search أو /checkout فقط — المسارات الديناميكية غير المخزّنة — فأنت تعرف أين تنظر بالضبط.
الاتصالات طويلة العمر تخضع للقاعدة نفسها. يُغلق اتصال WebSocket الذي لا يرسل شيئًا لمدة أطول من المهلة. امنح مسار WebSocket قاعدة منفصلة مع تفعيل السماح باتصالات WebSocket ومهلة تناسبه، أو أرسل رسالة نبض صغيرة أكثر تواترًا من الحد. يعرض دليل اتصال الخادم الأصلي الإعدادين معًا.
كيفية الإعداد
أدلة خطوة بخطوة في مركز المساعدة:
الأسئلة الشائعة حول 504 Gateway Timeout
هل 504 خطأ خادمي أم خطأ CDN؟
في معظم الحالات يُقضى الوقت على أصلك، والحافة هي التي انتظرت. قارن طلبًا عبر CDN بطلب مباشر إلى الأصل. إن كان الأصل وحده بطيئًا بالقدر نفسه، فالإصلاح على الأصل؛ وإن كان سريعًا مباشرةً وبطيئًا عبر CDN فقط، فابحث عن فرق في جدار الحماية أو التوجيه يؤثر في اتصال الحافة.
ما مهلة الأصل الافتراضية في cdn.com.tr؟
60 ثانية دون بيانات من أصلك. يمكنك ضبطها لكل قاعدة تسليم من 1 إلى 3,600 ثانية في مهلة استجابة الخادم الأصلي (بالثواني). وعلى نطاق تطبيق Managed Container تكون الافتراضية 300 ثانية.
هل أضبط المهلة على 3,600 ثانية في كل مكان؟
لا. المهلة الطويلة على كل مسار تعني أنه حين يتعطل شيء فعلًا، يتفرّج الزوار على مؤشر التحميل ساعة كاملة بدل أن يحصلوا على جواب في دقيقة، وتتراكم الطلبات العالقة على أصلك. أبقِ الافتراضي للموقع وارفعه فقط في قاعدة المسار البطيء بطبيعته.
لماذا ينجح التصدير مع الملفات الصغيرة ويفشل مع الكبيرة؟
لأنه يبني الملف كله قبل إرسال أول بايت. التصديرات الصغيرة تنتهي ضمن الحد، والكبيرة لا. بُثّ الملف أثناء توليده، أو شغّل التصدير مهمةً في الخلفية وأرسل رابط التنزيل عند جاهزيته.
هل يمكن أن أتلقى 504 رغم أن تطبيقي سريع؟
نعم، حين تصطف الطلبات قبل أن تبدأ. إن كان كل العمّال مشغولين، فقد ينتظر طلب سريع طويلًا بما يكفي لتنتهي مهلته. حالات 504 التي تظهر في ساعات الازدحام فقط تشير إلى السعة، لا إلى الشيفرة.
هل يفيد تحديث الصفحة؟
أحيانًا، لكن كل تحديث يبدأ العمل البطيء نفسه على أصلك من جديد. في الصفحات الثقيلة تضيف التحديثات المتكررة حملًا في اللحظة التي يعاني فيها الخادم أصلًا.