حل مشكلة خطأ 502 Bad Gateway

مقدمة

هل واجهت خطأ 502 Bad Gateway في موقعك؟ هذا الخطأ شائع جدًا في مواقع ووردبريس ويمكن أن يحدث لأسباب متعددة. يشير 502 إلى أن الخادم الذي يعمل كبوابة تلقّى استجابة غير صحيحة من خادم آخر.

في هذا المقال، نوضّح ما هو خطأ 502، أشهر أسبابه، وخطوات تشخيصه وحلّه خطوة بخطوة، مع أفضل الممارسات لمنع تكراره.

💡 نصيحة: أحيانًا يكون خطأ 502 مؤقتًا. انتظر قليلًا ثم أعد المحاولة. إذا استمر، ابدأ بخطوات التشخيص أدناه.

ما هو خطأ 502 Bad Gateway؟

هو خطأ HTTP يحدث عندما يفشل خادم وسيط (Gateway/Proxy) في الحصول على استجابة صحيحة من خادم التطبيق أو الـPHP-FPM أو قاعدة البيانات. غالبًا يكون السبب مشكلة اتصال أو موارد أو إعدادات.

أنواع خطأ 502

1. مؤقت: يظهر ويختفي تلقائيًا (غالبًا بسبب حمل لحظي).
2. دائم: يستمر حتى بعد إعادة المحاولة (غالبًا إعدادات/موارد).
3. متقطع: يحدث في أوقات الذروة أو عند مهام ثقيلة.

الأسباب الشائعة لخطأ 502

1) مشاكل في الخادم (Server Issues)

أسباب محتملة: استهلاك ذاكرة/CPU مفرط، إعدادات غير صحيحة، مشاكل شبكة.

الحلول: راجع لوحة الاستضافة لمراقبة الموارد، اضبط الحدود، وتواصل مع الدعم الفني إذا لزم.

2) مشاكل في PHP-FPM

PHP-FPM هو معالج PHP شائع. تعطل الخدمة أو امتلاء العاملين قد يسبب 502.

• أعد تشغيل PHP-FPM.
• راجع الإعدادات (pm.max_children، المهلات).
• زد حد الذاكرة عند الحاجة.

3) مشاكل في قاعدة البيانات

استعلامات بطيئة، جداول تالفة، أو قفل جداول قد يؤدي لبطء يمنع الاستجابة.

• حسّن الاستعلامات، أعد فهرسة الجداول.
• راجع هذا الدليل: كيفية حل مشكلة الأخطاء في قاعدة البيانات.

4) تعارضات الإضافات أو القوالب

إضافة أو قالب يستهلك موارد بشكل مبالغ/به أخطاء قد يسبب انقطاع الاستجابة.

• عطّل الإضافات واحدة تلو الأخرى.
• بدّل إلى قالب افتراضي مؤقتًا.
• راجع: حل مشكلة تعطل الموقع بعد تثبيت إضافة.

5) مشاكل في Cloudflare أو CDN

إعداد وضع الـProxy أو SSL في Cloudflare 5XX قد يسبب 502.

• راجع إعدادات SSL/TLS (مرن/كامل/كامل صارم).
• جرّب تعطيل Cloudflare مؤقتًا لفصل السبب.
• امسح الكاش وعدّل قواعد الـPage Rules إذا لزم.

خطوات حل المشكلة خطوة بخطوة

الخطوة 1: انتظار قصير وإعادة المحاولة

إن كان الحمل مؤقتًا، قد يختفي الخطأ خلال 5–10 دقائق. إن استمر، تابع.

الخطوة 2: إعادة تشغيل PHP-FPM

من cPanel:

1. سجّل دخول إلى cPanel.
2. ابحث عن PHP Selector أو MultiPHP Manager.
3. أعد تشغيل PHP-FPM.

عبر SSH (إن توفّر):
sudo service php-fpm restart
# أو
sudo systemctl restart php-fpm


الخطوة 3: زيادة حد الذاكرة في ووردبريس

1. افتح wp-config.php.
2. أضف قبل /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

للتوسع: كيفية إصلاح مشكلة الذاكرة المستنفدة في ووردبريس.

الخطوة 4: زيادة مهلة التنفيذ

Apache/.htaccess:
php_value max_execution_time 300
php_value max_input_time 300

إن كنت تستخدم Nginx فستحتاج لتعديل إعدادات الخادم بدلًا من .htaccess، راجع أدناه.

الخطوة 5: تعطيل الإضافات

عبر FTP:

• اذهب إلى wp-content/plugins/.
• غيّر اسم مجلد plugins إلى plugins-disabled ثم اختبر.

إن عمل الموقع، أعد الاسم ثم عطّل الإضافات فرديًا (أعد تسمية كل مجلد على حدة) لاكتشاف المسبب.

الخطوة 6: تغيير القالب

• اذهب إلى wp-content/themes/ وغيّر اسم القالب الحالي.
• سيرجع ووردبريس لقالب افتراضي؛ إن اختفى الخطأ فالمشكلة في القالب.

الخطوة 7: إصلاح قاعدة البيانات

phpMyAdmin: حدّد جميع الجداول ثم اختر Repair.

WP-CLI:
wp db repair


الخطوة 8: فحص إعدادات Cloudflare/CDN

1. سجّل الدخول إلى Cloudflare.
2. تحقق من SSL/TLS وEdge Certificates.
3. امسح الكاش (Purge Everything).
4. جرّب Pause Cloudflare on Site مؤقتًا لعزل السبب.

مرجع مفيد: Troubleshooting Cloudflare 5XX.

حلول متقدمة

تعديل إعدادات PHP-FPM

SSH:
sudo nano /etc/php-fpm.d/www.conf

قيَم مقترحة (حسب موارد الخادم):
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35
pm.max_requests = 500

sudo service php-fpm restart


تعديل إعدادات Nginx

sudo nano /etc/nginx/nginx.conf

proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;
send_timeout 300;

sudo service nginx restart

مراجع رسمية: Nginx Docs.

منع تكرار المشكلة

1) تحديثات منتظمة

• حدّث ووردبريس والإضافات والقوالب.
• راجع: مشاكل تحديث ووردبريس — كيف تتجنبها وتحلها.

2) مراقبة الأداء

• راقب الذاكرة وCPU من لوحة الاستضافة.
• استخدم أدوات مراقبة أخطاء/أداء.

3) مصادر موثوقة

• ثبّت إضافات من مطورين موثوقين مع مراجعة التقييمات.
• اختبر على بيئة Staging قبل الإنتاج.

4) نسخ احتياطية

• أنشئ نسخًا احتياطية دورية واختبر الاستعادة.

الأسئلة الشائعة (FAQ)

س1: ما هو خطأ 502؟

ج: فشل الخادم الوسيط في تلقي استجابة صحيحة من خادم التطبيق/المنشأ.

س2: هل هو مؤقت؟

ج: غالبًا نعم، لكنه قد يستمر إن كان السبب موارد/إعدادات.

س3: أسباب شائعة؟

• موارد الخادم، PHP-FPM، قاعدة البيانات، الإضافات/القوالب، Cloudflare/CDN.

س4: كيف أصلحه بسرعة؟

1. انتظر قليلًا ثم أعد المحاولة.
2. أعد تشغيل PHP-FPM.
3. زد الذاكرة والمهلات.
4. عطّل الإضافات وبدّل القالب.
5. أصلح الجداول/الاستعلامات البطيئة.

س5: تأثيره على SEO؟

ج: التكرار يضر بالزحف وتجربة المستخدم؛ أصلحه سريعًا.

الخلاصة

خطأ 502 Bad Gateway مزعج لكنه قابل للحل. ابدأ بالبساطة (إعادة المحاولة، إعادة تشغيل PHP-FPM)، ثم زِد الذاكرة والمهلات، وافحص الإضافات والقالب وقاعدة البيانات. إن استمر، اتجه لإعدادات Nginx/PHP-FPM وCloudflare، وراقب الموارد باستمرار.

للمقارنة وحالات مشابهة، راجع: كيفية حل مشكلة خطأ 504 Gateway Timeout وكيفية إصلاح خطأ 500 Internal Server Error في ووردبريس.

هذا المقال جزء من سلسلة الدعم التقني. تصفّح بقية الأدلة في قسم الصيانة والأداء.