يعني خطأ HTTP 502 أن خادمًا وسيطًا تلقّى ردًا غير صالح من الخادم الأصلي
خطأ HTTP 502 أو «Bad Gateway» يعني أن الخادم الذي وصلت إليه كان وسيطًا فقط، وأن الخادم الذي خلفه ردّ برد غير صالح أو لم يردّ بشيء يمكن استخدامه. الوسيط (مثل Nginx أو Apache أو Cloudflare أو موزّع أحمال من AWS) يعمل بشكل سليم، أما الخادم الذي خلفه فلا.
هذا الرمز من فئة 5xx، أي أنه بحكم التعريف خطأ من جهة الخادم. وهو أدق من الرمز 500: فهو يوضح أن العطل حدث عند نقطة التسليم بين البوابة وخادم التطبيق. وتضيف صفحة المرجع في MDN (آخر تحديث 22 يونيو 2026) أنه لو أرسل الخادم الأصلي خطأ HTTP صحيحًا، لكان على البوابة أن تمرره بدلًا من ذلك؛ أما الرمز 502 فيعني أن البوابة لم يكن لديها ما تمرره.
قد تراه كصفحة بيضاء بسيطة مكتوب عليها '502 Bad Gateway' في المتصفح، أو كرسالة 'HTTP error! status: 502' داخل مربع الخطأ في أحد التطبيقات، أو في Zoom أو الألعاب أو تطبيقات التداول كرسالة عامة 'خطأ في الخادم' يظهر الرمز 502 في تفاصيلها. والمعنى واحد في كل مرة: الجزء الخلفي من الخدمة لم يرد على واجهتها الأمامية.
تلقى الخادم، أثناء عمله كبوابة أو وكيل، استجابة غير صالحة من خادم وارد اتصل به أثناء محاولته تنفيذ الطلب.
RFC 9110، كما ورد في صفحة 502 على موقع Authgear
يمر الطلب عبر بوابة وسيطة، ومن هناك يظهر الخطأ 502
يصدر الرمز 502 من الحلقة الوسطى: يتصل متصفحك ببوابة (وكيل عكسي أو CDN أو موزّع أحمال)، وتتصل البوابة بخادم التطبيق، وتعيد البوابة الرمز 502 عندما تفشل هذه الخطوة الأخيرة.
تذكر صفحة Authgear أربع حالات تفشل فيها الخطوة الأخيرة: خادم التطبيق لا يعمل، أو يغلق الاتصال بشكل غير متوقع، أو يعيد استجابة HTTP غير سليمة، أو يستغرق وقتًا أطول من مهلة البوابة. وفي الحالات الأربع لا يكون لدى البوابة ما يصلح لتمريره، فتكتب صفحة خطأ قصيرة خاصة بها وترسلها بدلًا من ذلك.
يدل الشعار أو الشكل على صفحة الخطأ على الوسيط الذي لم يحصل على رد. فإذا كانت صفحة 502 بتصميم Cloudflare، فهذا يعني أن Cloudflare لم تحصل على رد سليم من الخادم الأصلي للموقع. وإذا كانت الصفحة بسيطة وكُتب في أسفلها 'nginx' أو 'openresty'، فهذا يعني أن الوكيل الخاص بالموقع لم يستطع الوصول إلى تطبيقه على الجهاز نفسه أو الشبكة نفسها.
علامات تدل على أن العطل في الموقع
- يبلغ آخرون عن الخطأ نفسه في الوقت نفسه
- صفحة الخطأ تحمل شعار الموقع أو شبكة CDN وعلامتها
- جميع صفحات الموقع تفشل، وليس صفحة واحدة فقط
- هاتفك على بيانات الجوال يعرض الخطأ 502 نفسه
علامات تدل على أن المشكلة من جانبك
- الموقع يعمل الآن عند صديق لك
- يظهر الخطأ على شبكة واحدة فقط (المنزل أو المقهى أو المكتب)
- يختفي الخطأ عندما تغيّر خادم VPN أو توقف تشغيل VPN
- بدأ الخطأ مباشرة بعد تغيير إعدادات DNS أو البروكسي
الأخطاء 502 و503 و504 ثلاث حالات مختلفة تصدر عن البوابة نفسها
الخطأ 502 يعني أن الخادم الخلفي رد ردًا غير صالح، والخطأ 503 يعني أن الخدمة غير متاحة عمدًا أو أنها مثقلة بالطلبات، والخطأ 504 يعني أن الخادم الخلفي لم يرد إطلاقًا قبل انتهاء مهلة البوابة.
هذا الفرق مهم لأنه يغيّر ما عليك فعله. الخطأ 503 يأتي غالبًا مع تلميح Retry-After ويزول في موعد محدد. أما الخطأ 504 فيشير إلى بطء، وحله بالانتظار أو بتعديل إعداد المهلة. والخطأ 502 يشير إلى تعطل أو منفذ خاطئ أو رد تالف، وهذا يحتاج إلى شخص يعالجه من جهة الخادم.
| الرمز | ما رصدته البوابة | من يتولى إصلاحه عادةً | ما الذي يمكن للزائر فعله |
|---|---|---|---|
| 500 خطأ داخلي في الخادم | التطبيق نفسه أصدر خطأً | مطورو الموقع | أعد التحميل مرة واحدة، ثم انتظر |
| 502 بوابة غير صالحة | رد غير صالح أو فارغ من الخادم المصدر | مسؤولو الموقع (الوكيل أو التطبيق) | أعد تحميل الصفحة، وجرّب شبكة أخرى، ثم انتظر |
| 503 الخدمة غير متاحة | أفادت الخدمة بأنها متوقفة أو عليها ضغط زائد | مسؤولو الموقع، وغالبًا يكون ذلك متعمدًا أثناء الصيانة | انتظر حتى تنتهي مدة Retry-After |
| 504 انتهت مهلة البوابة | لم يصل أي رد خلال مهلة البوابة | مسؤولو الموقع (خادم خلفي بطيء أو إعداد المهلة) | انتظر بضع دقائق ثم حاول مرة أخرى |
ماذا تفعل عندما يظهر لك خطأ HTTP 502 كزائر
أعد تحميل الصفحة مرة واحدة بعد انتظار قصير، ثم جرّب الصفحة نفسها من شبكة أخرى. إذا فشلت المحاولتان، فالموقع متوقف ولن يغيّر أي إعداد على جهازك هذا.
نرى أن معظم الزوار يبالغون في تشخيص الخطأ 502. النصيحة الصريحة هي الانتظار ثلاث دقائق قبل تغيير أي إعداد، لأن العملية المتعطلة من جهة الموقع يعيد نظام المراقبة الخاص به تشغيلها عادةً خلال هذه المدة. الخطوات أدناه مخصصة للحالات القليلة التي يكون فيها الخطأ مرتبطًا بجهازك أو بشبكتك.
أعد تحميل الصفحة بعد انتظار قصير
عُدّ حتى ثلاثين ثم اضغط على إعادة التحميل. كثيرًا ما يختفي الخطأ 502 الناتج عن إعادة تشغيل الخادم الخلفي عند المحاولة الثانية أو الثالثة.
جرّب شبكة أخرى
افتح العنوان نفسه على هاتفك عبر بيانات الجوال. إذا ظهر الخطأ 502 هناك أيضًا، فتوقف عن استكشاف الأخطاء: المشكلة في الموقع.
امسح ذاكرة DNS المؤقتة
على Windows، افتح Terminal كمسؤول ونفّذ الأمر ipconfig /flushdns، ثم netsh winsock reset، كما يقترح رد مجتمع Microsoft بتاريخ 20 أبريل 2026. قد يوجّهك إدخال DNS قديم إلى بوابة لم تعد تعمل بشكل سليم.
بدّل خادم VPN أو أوقف VPN للاختبار
إذا كنت تستخدم VPN، فاختر خادمًا في بلد مختلف ثم أعد تحميل الصفحة. إذا تغيّرت النتيجة فهذا يعني أن أحد المواقع الطرفية كان به عطل، وليس جهازك. أعد تشغيل VPN بعد ذلك إن احتجت إليه.
تحقق من صفحة حالة الموقع أو من حسابه على وسائل التواصل الاجتماعي
تنشر الخدمات الكبيرة أخبار الأعطال خلال دقائق. إذا كتبت «جارٍ التحقق من المشكلة»، فأغلق التبويب وعد لاحقًا.
امسح ملفات تعريف الارتباط لهذا الموقع فقط
هذا نادر، لكن قد يتسبب ملف تعريف ارتباط تالف للجلسة في أن ترفض بوابة المصادقة الطلب وتعيد الخطأ 502. امسح ملفات تعريف الارتباط لهذا النطاق وحده، وليس لكامل المتصفح.
إذا كنت تدير الموقع، فثلاثة حلول تعالج معظم أخطاء 502
أعد تشغيل الخادم الخلفي الذي توقف، ووجّه الوكيل إلى المنفذ الصحيح، وارفع مهلة القراءة في الوكيل. تقول Authgear إن السبب في تسع حالات من كل عشر يكون واحدًا من هذه الأمور الثلاثة.
إلى جانب هذه الأمور الثلاثة، تشمل الأسباب المعتادة: موازن أحمال وضعت فحوصات الحالة فيه كل الخوادم الخلفية في خانة غير السليمة، أو وكيل خزّن إجابة DNS قديمة للخادم الخلفي، أو فشل مصافحة TLS بين الوكيل والخادم الخلفي، أو نفاد الذاكرة أو عمليات العمل لدى الخادم الخلفي. يترك كل سبب منها سطرًا في سجل أخطاء الوكيل، لذا اقرأ هذا السجل قبل تغيير الإعدادات.
تأكد من أن التطبيق يستمع على المنفذ
نفّذ الأمر ss -tlnp | grep <port> على الخادم. إذا لم يكن هناك أي شيء يستمع على المنفذ الذي يتوقعه الوكيل، فشغّل التطبيق واقرأ سبب توقفه.
تحقق من وجهة الوكيل
في Nginx راجع proxy_pass، وفي Apache راجع ProxyPass. أي منفذ خاطئ أو مسار مقبس خاطئ أو استخدام http:// في الحالة التي يعمل فيها التطبيق عبر https:// يؤدي بشكل مؤكد إلى الخطأ 502.
قارن المهل الزمنية بأوقات الاستجابة الفعلية
إذا كان التطبيق بطيئًا فقط، فارفع proxy_read_timeout في Nginx أو ProxyTimeout في Apache، ثم حلّل أداء النقطة البطيئة حتى لا تخفي المهلة الزمنية خطأً برمجيًا.
أعد إنتاج المشكلة باستخدام curl من مضيف البروكسي
تنفيذ الأمر curl -v http://127.0.0.1:<port>/ من الجهاز نفسه يوضّح ما إذا كان الخادم الخلفي (upstream) يردّ أصلًا، وما إذا كانت ترويساته HTTP صالحة.
افحص حالة موزّع الأحمال
في AWS ALB أو Kubernetes Ingress أو ما يشبههما، تُرجع مجموعة الأهداف التي لا تضم أي خادم خلفي سليم الخطأ 502 للجميع. أصلح مسار فحص الصحة أو استجابة الجاهزية في التطبيق.
نادرًا ما يتسبب VPN في الخطأ 502، لكن قد يوصلك خادم خروج معيّن إلى خادم حافة يعاني من مشكلة
لا يتسبب VPN في أخطاء 502 من تلقاء نفسه. تذكر MDN أن VPN وغيره من إعدادات الشبكة المخصصة استثناء يستحق الفحص فقط عندما يعمل الموقع عند الجميع غيرك.
وهذا سبب أن تغيير الخادم يفيد أحيانًا. المواقع الكبيرة تردّ من حافة CDN الأقرب إلى عنوان IP الخاص بمخرجك. إذا كانت هذه الحافة وحدها، أو مسارها إلى الخادم الأصلي، غير سليمة، فسيرى كل من يخرج عبر هذا المخرج الخطأ 502 بينما يتصفح الآخرون في أماكن أخرى بشكل طبيعي. اختيار خادم في بلد آخر يوجّهك إلى حافة مختلفة، وهذا اختبار مشروع وليس حيلة. يمكنك التأكد من المخرج الذي تستخدمه عبر tealvpn.com/what-is-my-ip قبل التبديل وبعده.
يقدّم Teal VPN من Fxolio LLC خطة مجانية (500 ميغابايت يوميًا) وخطة Pro، مع تطبيقات لأجهزة Android وWindows وMac وLinux وAndroid TV وChromebook، وخوادم في 14 دولة اعتبارًا من نوفمبر 2026. تقنية Teal Secure مفعّلة في كل اتصال وكل خطة: فهي تُخفي طبيعة حركة VPN، ويجرّب التطبيق مسارات أخرى تلقائيًا عندما تغلق الشبكة أحدها. هذا يفيد في الشبكات التي تقيّد VPN، لكنه لا يغيّر شيئًا في الخطأ 502، لأن 502 يعني أن الخادم الخلفي للموقع نفسه يتعطل. لا يوجد VPN مضمون الاتصال على كل شبكة، ولا يستطيع أي VPN إصلاح خادم يخص جهة أخرى.
- قبل أن تلوم VPN: هل يظهر الخطأ 502 عند إيقاف VPN على الشبكة نفسها؟
- هل يظهر أيضًا عند اختيار خادم في بلد آخر؟
- هل تحمل صفحة الخطأ اسم شبكة CDN (مثل Cloudflare أو Fastly) بدلًا من اسم الموقع؟
- هل ظهر الخطأ نفسه لصديق خارج شبكتك في الدقيقة نفسها؟
يمكن لأصحاب المواقع منع تكرار أخطاء 502 عبر فحوصات الحالة ومهل انتظار واقعية
يتوقف تكرار الخطأ 502 عندما يعرف الوكيل الحالة الفعلية للتطبيق: نقطة جاهزية يستدعيها فحص الحالة، ومدير عمليات يعيد تشغيل التطبيق عند تعطله، ومهلة للوكيل تُحدَّد من أوقات الاستجابة المقاسة بدل التخمين.
هناك عادتان أخريان مفيدتان. اجعل مدة تخزين DNS المؤقت في الوكيل للخادم الخلفي قصيرة، حتى لا يبقى الوكيل متجهًا إلى العنوان القديم بعد النشر على عنوان جديد. وأنشئ تنبيهًا على عدد أخطاء 502 نفسها، وليس على المعالج أو الذاكرة فقط، لأن سطر proxy_pass الخاطئ لا يسبب أي حمل لكنه يعطي نسبة خطأ مئة بالمئة.
تابع القراءة
المراجع
- 502 Bad Gateway - HTTP | MDN
- HTTP 502 Bad Gateway: Causes & Fixes | Authgear
- how do you get 502 - Microsoft Q&A
تحتاج مساعدة في Teal VPN؟ تواصل مع الدعم.
أسئلة
ماذا يعني خطأ HTTP 502؟
يعني أن خادمًا يعمل كبوابة أو وكيل (بروكسي) تلقّى ردًا غير صالح، أو لم يتلقَّ ردًا يمكن استخدامه، من الخادم الذي يقف خلفه. البوابة تعمل بشكل سليم، لكن خادم التطبيق لم يردّ كما يجب.
هل خطأ HTTP 502 سببه أنا؟
نادرًا جدًا. هذا رمز من فئة 5xx، وهي بحكم تعريفها أخطاء من جهة الخادم. جرّب الدخول من شبكة أخرى؛ فإذا ظهر الخطأ 502 هناك أيضًا، فالمشكلة في الموقع نفسه والحل هو الانتظار.
كم يستمر الخطأ 502؟
غالبًا من بضع ثوانٍ إلى بضع دقائق، لأن أنظمة المراقبة تعيد تشغيل العملية التي تعطلت. وإذا استمر أكثر من خمس عشرة دقيقة، فالأرجح أن لدى مسؤولي الموقع مشكلة في الإعدادات وليس مجرد عطل، وهم وحدهم من يستطيع إصلاحها.
ما الفرق بين 502 و504؟
الخطأ 502 يعني أن الخادم الخلفي ردّ بشيء غير صالح، أما 504 فيعني أنه لم يردّ إطلاقًا قبل انتهاء مهلة البوابة. وهذا هو التفريق الذي تعتمده MDN: إذا لم يصل أي رد HTTP من الخادم الأصلي يظهر 504، وإذا كان الرد سيئًا يظهر 502.
هل يمكن لـ VPN إصلاح خطأ HTTP 502؟
فقط في حالة محدودة، وهي أن تكون إحدى نقاط CDN القريبة من عنوان IP الخاص بالخروج لديك معطلة. عند التبديل إلى خادم Teal VPN في بلد آخر، تتصل بنقطة مختلفة؛ فإذا بقي الخطأ، فهذا يعني أن الخادم الخلفي للموقع متوقف ولن يفيد أي VPN.
لماذا يظهر خطأ HTTP 502 في Zoom أو في لعبة؟
تتواصل التطبيقات مع بوابات من النوع نفسه الذي تستخدمه المواقع. وعندما يتعطل الخادم الخلفي للخدمة أو يتحمل ضغطًا زائدًا، تعيد بوابة التطبيق الخطأ 502، ويعرضه التطبيق على شكل "HTTP error! status: 502" أو كرسالة خطأ عامة من الخادم.
ماذا يعني الخطأ 502 من ngrok؟
وصل النفق إلى جهازك، لكن لم يرد أي شيء على المنفذ المحلي الذي طلبت من ngrok التوجيه إليه. شغّل التطبيق المحلي على هذا المنفذ، أو صحّح رقم المنفذ في أمر ngrok.