خطأ 502 Bad Gateway في موقعك: الخادم أم PHP أم Cloudflare
باختصار: خطأ 502 يعني أن خادماً وسيطاً طلب الصفحة من الخادم الذي خلفه فتلقى رداً غير صالح أو لم يتلقَّ شيئاً. في موقع ووردبريس نموذجي هناك ثلاث طبقات محتملة: Cloudflare أمام الموقع، ثم nginx أو Apache على الخادم، ثم PHP-FPM الذي يشغّل الكود. شكل صفحة الخطأ يخبرك من عرضها، وسجل أخطاء الخادم يخبرك أي طبقة فشلت. الأسباب الأكثر تكراراً هي امتلاء عمليات PHP، ونفاد الذاكرة، ومهام ثقيلة تعمل في وقت الذروة. وإن لم يكن لديك وصول إلى السجلات، فأرسل للمستضيف أوقاتاً دقيقة وروابط محددة.
ماذا يعني 502 بلغة بسيطة
تخيّل سلسلة من ثلاثة أشخاص: موظف استقبال يأخذ طلب الزبون، وينقله إلى مشرف، والمشرف ينقله إلى المطبخ. إن عاد المشرف إلى موظف الاستقبال بلا جواب أو بجواب غير مفهوم، يقول موظف الاستقبال للزبون: «حصل خطأ في البوابة». هذا هو 502. الذي يعرض الخطأ ليس بالضرورة من سببه، بل هو آخر من رأى المشكلة. التعريف التقني في صفحة MDN عن الرمز 502.
موقع شركة تأجير معدات في إربد، نسميه «معدات الشمال»، كان يعرض 502 بضع دقائق صباح كل أحد تقريباً. صاحب الشركة جرب حذف الكاش وإعادة تشغيل الراوتر بلا فائدة. السبب، كما سنرى، كان في الخادم.
الخطوة الأولى: من عرض صفحة الخطأ؟
انظر إلى الصفحة نفسها جيداً:
| ما تراه | من عرض الخطأ | أين تبحث |
|---|---|---|
| صفحة Cloudflare فيها رسم للمتصفح وCloudflare والخادم، والخادم معلّم بالخطأ | Cloudflare، والخادم الأصلي هو الذي لم يرد جيداً | سجلات الخادم الأصلي |
| صفحة Cloudflare والخطأ عند Cloudflare نفسها | مشكلة لدى Cloudflare، وهذا أندر | صفحة حالة Cloudflare |
| صفحة بيضاء بسيطة فيها 502 Bad Gateway وتحتها nginx | nginx على خادمك لم يحصل على رد من PHP أو من تطبيق خلفه | سجل nginx وسجل PHP-FPM |
| صفحة من شركة الاستضافة بتصميمها | وكيل لدى المستضيف | دعم المستضيف |
Cloudflare تشرح صفحات أخطاء 5xx وما يعنيه كل منها في توثيق أخطاء 5xx. من المفيد أيضاً أن تنسخ رقم Ray ID الظاهر أسفل صفحة Cloudflare، فهو يحدد الطلب بدقة.
اختبار سريع لتجاوز Cloudflare
إن كان لديك عنوان IP الخادم، فاطلب من المطور أو المستضيف فتح الموقع مباشرة عليه، أو أوقف الوكيل مؤقتاً لسجل DNS (السحابة الرمادية) لدقائق في وقت هادئ. إن ظهر الخطأ نفسه دون Cloudflare، فالمشكلة في الخادم بلا شك.
الخطوة الثانية: اقرأ السجلات
في لوحة الاستضافة، سواء cPanel أو Plesk أو لوحة خاصة، ابحث عن Error logs. على خادم VPS يديره مطورك، السجلات عادة في مسار مثل /var/log/nginx/error.log وسجل PHP-FPM في مسار قريب حسب الإصدار.
عبارات تدل على السبب:
- connect() to unix:/run/php/... failed أو Resource temporarily unavailable: nginx لم يستطع الوصول إلى PHP-FPM، غالباً لأن كل عملياته مشغولة أو لأن الخدمة متوقفة.
- upstream prematurely closed connection: PHP بدأ الرد ثم انقطع، وقد يكون السبب نفاد الذاكرة أو انهيار العملية.
- server reached pm.max_children setting في سجل PHP-FPM: كل العمليات المسموحة مشغولة، والطلبات الجديدة تنتظر أو تُرفض.
- Out of memory أو Killed process في سجلات النظام: نظام التشغيل أنهى عملية لأن الذاكرة نفدت.
سجّل وقت ظهور الخطأ كما رآه الزبون، ثم ابحث في السجل عن الدقيقة نفسها. هذا يختصر ساعات.
الذاكرة وعمليات PHP
PHP-FPM يشغّل عدداً محدوداً من العمليات معاً، يحدده إعداد pm.max_children. كل عملية تستهلك ذاكرة، وتزيد مع الإضافات الثقيلة. إن كان الحد منخفضاً جداً، تنتظر الطلبات وتظهر 502 أو 504 في الذروة. وإن كان مرتفعاً جداً مقارنة بذاكرة الخادم، تنفد الذاكرة ويقتل النظام عمليات، فتظهر 502 أيضاً.
الحل ليس رفع الرقم عشوائياً. يقيس المطور متوسط ذاكرة العملية الواحدة، ويقسم الذاكرة المتاحة لـ PHP عليه، ويترك هامشاً لقاعدة البيانات والنظام. خيارات الإعداد مشروحة في دليل إعدادات PHP-FPM.
على الاستضافة المشتركة لا تتحكم في هذه الأرقام، لكن المستضيف يستطيع أن يخبرك إن كان حسابك يصطدم بحد العمليات أو الذاكرة.
المهام الثقيلة: سبب 502 الدوري
حين يظهر الخطأ في أوقات متكررة، ابحث عن مهمة مجدولة. في حالة «معدات الشمال» كانت:
- نسخة احتياطية كاملة تبدأ صباح الأحد، وهو أول يوم عمل والزيارات فيه مرتفعة.
- إضافة تحسين صور تعالج مئات الصور دفعة واحدة.
- WP-Cron الذي يشتغل مع زيارات الموقع، فيصادف أن تبدأ مهام ثقيلة في الذروة.
بعد نقل النسخة الاحتياطية إلى الثالثة فجراً، وجعل معالجة الصور على دفعات صغيرة، اختفى الخطأ. لم يحتج الموقع إلى خادم أكبر.
مصادر أخرى للحمل المفاجئ: زواحف وروبوتات تطلب آلاف الصفحات، أو هجوم على صفحة تسجيل الدخول، أو بحث داخلي في متجر يُطلب بكثافة. سجل الوصول (access log) يكشف عناوين IP التي ترسل طلبات كثيرة.
خطوات يمكنك تجربتها بنفسك
- عطّل الإضافات المضافة حديثاً على نسخة تجريبية، وراقب هل يتوقف الخطأ.
- تحقق من إصدار PHP في لوحة الاستضافة، وتأكد أنه مدعوم من قالبك وإضافاتك.
- أوقف مؤقتاً أي إضافة نسخ احتياطي أو تحسين صور تعمل في النهار.
- فعّل الكاش للصفحات العامة، فهذا يخفف الطلبات التي تصل إلى PHP.
- راقب الموقع بأداة فحص توفر مجانية تنبهك بالوقت الدقيق لكل انقطاع.
رسالة جاهزة للدعم الفني
المستضيف يستجيب أسرع حين تعطيه معلومات محددة. انسخ هذا وعدّله:
مرحباً، موقعنا (اسم النطاق) يعرض خطأ 502 Bad Gateway بشكل متقطع. آخر ثلاث مرات: (التاريخ والساعة بتوقيت عمّان لكل مرة). الصفحات المتأثرة: (روابط). الموقع خلف Cloudflare، ورقم Ray ID لإحدى المرات: (الرقم). نرجو التحقق من سجلات nginx وPHP-FPM في هذه الأوقات، وإخبارنا إن كان الحساب يصل إلى حد العمليات أو الذاكرة، وما المهام التي كانت تعمل حينها.
أسئلة شائعة
ما الفرق بين 502 و504؟
في 502 وصل رد غير صالح أو انقطع الاتصال. في 504 انتظر الوكيل طويلاً ولم يصل رد في الوقت المحدد. السببان متقاربان، وكثيراً ما يظهران معاً عند الضغط.
هل يتسبب Cloudflare في 502؟
نادراً. في أغلب الحالات Cloudflare يعرض الخطأ لأن خادمك لم يرد بشكل صحيح.
هل حذف الكاش في المتصفح يحل المشكلة؟
لا عادة، فالخطأ يأتي من الخادم. قد يبدو أنه حُل لأن المشكلة متقطعة أصلاً.
متى أحتاج إلى خادم أكبر؟
بعد التأكد من أن الإعدادات معقولة والمهام الثقيلة مجدولة جيداً، ويبقى الخادم ممتلئاً في ساعات العمل العادية.
إن كان موقعك يتوقف بخطأ 502 ولا تصل إلى سبب في السجلات، أرسل لنا أوقات الانقطاع ونفحص الطبقات معك.