502 Bad Gateway और 504 Gateway Timeout एरर कैसे ठीक करें? Nginx, Cloudflare और PHP-FPM सर्वर SOP

जब आप एक आधुनिक वेबसाइट चलाते हैं, तो वेब आर्किटेक्चर अक्सर कई स्तरों (Layers) में काम करता है: सबसे आगे Cloudflare CDN या Nginx रिवर्स प्रॉक्सी होती है, और उसके पीछे मुख्य एप्लीकेशन सर्वर (जैसे PHP-FPM, Apache या Node.js) और डेटाबेस काम कर रहे होते हैं। जब इस मल्टी-टियर सिस्टम में कोई एक घटक दूसरे से ठीक से बात नहीं कर पाता, तो स्क्रीन पर दो सबसे कुख्यात गेटवे एरर्स दिखाई देते हैं: "502 Bad Gateway" और "504 Gateway Timeout"।

अक्सर ब्लॉगर्स और डेवलपर्स इन दोनों एरर्स में भ्रमित हो जाते हैं और गलत फाइल्स में बदलाव करने लगते हैं। यह समझना जरूरी है कि 502 और 504 एक ही सिक्के के दो अलग-अलग पहलू हैं। 502 का मतलब है कि आपके गेटवे को पीछे से "गलत जवाब" मिला, जबकि 504 का मतलब है कि उसे तय समय में "कोई जवाब ही नहीं मिला"।

इस विस्तृत गाइड में हम Nginx प्रॉक्सी सेटिंग्स, PHP-FPM प्रोसेस पूल ट्यूनिंग, क्लाउडफ्लेयर एज रूल्स और सर्वर लॉग एनालिसिस के जरिए इन दोनों एरर्स को जड़ से मिटाने की 100% प्रैक्टिकल SOP समझेंगे ताकि आपकी साइट कभी भी डाउन न हो।

1. 502 Bad Gateway और 504 Gateway Timeout क्या हैं? बुनियादी अंतर

इंटरनेट के HTTP प्रोटोकॉल में 'Gateway' (गेटवे) उस सर्वर को कहा जाता है जो विज़िटर के अनुरोध को मुख्य बैकएंड सर्वर तक पहुँचाने वाले मध्यस्थ (Reverse Proxy / Load Balancer) के रूप में कार्य करता है।

502 Bad Gateway (अमान्य रिस्पॉन्स):

• क्या होता है: Nginx या Cloudflare ने आपके बैकएंड PHP सर्वर से संपर्क किया। बैकएंड ने जवाब तो भेजा, लेकिन वह जवाब विकृत, आधा-अधूरा, या अमान्य हेडर वाला था।
• सबसे आम कारण: PHP-FPM सर्विस का अचानक क्रैश हो जाना, सर्वर की रैम 100% भर जाना, या Nginx और PHP-FPM के बीच यूनिक्स सॉकेट (Unix Socket) की परमिशन टूटना।

504 Gateway Timeout (समय सीमा समाप्त):

• क्या होता है: गेटवे ने बैकएंड से अनुरोध किया, लेकिन बैकएंड सर्वर ने तय समय (डिफ़ॉल्ट रूप से 60 सेकंड) के भीतर कोई उत्तर ही नहीं दिया। गेटवे ने इंतज़ार करते-करते थककर हाथ खड़े कर दिए और विज़िटर को 504 एरर दिखा दिया।
• सबसे आम कारण: भारी डेटाबेस क्वेरी का फंस जाना (Database Deadlock), कोई बाहरी एपीआई कॉल का हैंग हो जाना, या किसी बड़े बैकअप/प्लगइन का अनंत लूप में चलना।

2. 5-कॉलम तुलना सारणी: 502 बनाम 504 एरर, घटक, लॉग संकेत और समाधान समय

नीचे दी गई सारणी में दोनों गेटवे एरर्स के तकनीकी लक्षणों, उनके उत्तरदायी घटकों और समाधान की स्पष्ट तुलना की गई है:

3. 502 Bad Gateway का समाधान: PHP-FPM सर्विस क्रैश और सॉकेट मिसमैच

यदि आपकी साइट पर 502 एरर आ रहा है, तो 90% मामलों में इसका कारण PHP-FPM सर्विस का बंद होना होता है:

स्टेप 1: PHP-FPM का स्टेटस जांचें और रीस्टार्ट करें

1. टर्मिनल में SSH लॉगिन करें और यह कमांड चलाएं:

   sudo systemctl status php8.2-fpm

   (यदि आप PHP 8.1 या 8.3 इस्तेमाल कर रहे हैं, तो अपने वर्जन का नंबर डालें)।
2. यदि स्टेटस में Active: failed या dead लिखा है, तो सर्विस को रीस्टार्ट करें:

   sudo systemctl restart php8.2-fpm

3. वेबसाइट को रीफ्रेश करें। अधिकांश मामलों में 502 एरर तुरंत गायब हो जाता है।

स्टेप 2: Nginx और PHP-FPM सॉकेट पाथ का मिलान करना

कई बार PHP अपडेट होने के बाद Nginx पुराने सॉकेट (जैसे php8.1-fpm.sock) को ढूंढता रहता है जबकि सिस्टम में नया सॉकेट (php8.2-fpm.sock) बन चुका होता है:

1. जांचें कि आपके सर्वर में कौन सी सॉकेट फाइल मौजूद है:

   ls -la /run/php/

2. अपनी Nginx साइट कन्फिगरेशन फाइल (/etc/nginx/sites-available/yourdomain) खोलें और fastcgi_pass लाइन देखें:

   fastcgi_pass unix:/run/php/php8.2-fpm.sock;

3. सुनिश्चित करें कि यहाँ लिखा गया वर्जन नंबर और /run/php/ में मौजूद फाइल का नाम 100% एक जैसा हो।
4. Nginx कॉन्फ़िगरेशन टेस्ट करें और रीलोड करें:

   sudo nginx -t && sudo systemctl reload nginx

4. 504 Gateway Timeout का समाधान: स्लो क्वेरीज और Nginx टाइमआउट बढ़ाना

यदि स्क्रीन पर 504 एरर आ रहा है, तो इसका मतलब है कि Nginx बहुत जल्दी उम्मीद छोड़ रहा है। डिफ़ॉल्ट 60 सेकंड की सीमा को बढ़ाकर 300 सेकंड (5 मिनट) करने से टाइमआउट एरर हल हो जाता है:

Nginx में टाइमआउट बढ़ाने का सटीक कोड:

1. अपनी Nginx साइट कन्फिग फाइल खोलें और location ~ .php$ ब्लॉक के अंदर ये 3 लाइनें जोड़ें:

   fastcgi_read_timeout 300;
   fastcgi_send_timeout 300;
   fastcgi_connect_timeout 300;

2. यदि आप Nginx को रिवर्स प्रॉक्सी की तरह इस्तेमाल कर रहे हैं (जैसे Apache या Node.js के आगे), तो मुख्य http { ... } ब्लॉक या server { ... } ब्लॉक में यह कोड जोड़ें:

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

3. Nginx को रीलोड करें: sudo systemctl reload nginx।

PHP सेटिंग्स में टाइमआउट सिंक करना:

Nginx का टाइमआउट बढ़ाने के साथ-साथ PHP का टाइमआउट बढ़ाना भी अनिवार्य है, वरना PHP 60वें सेकंड पर स्क्रिप्ट को मार देगा:

• अपनी php.ini फाइल में max_execution_time = 300 सेट करें।
• PHP-FPM पूल फाइल (/etc/php/8.2/fpm/pool.d/www.conf) में request_terminate_timeout = 300 सेट करें और सर्विस रीस्टार्ट करें।

5. Cloudflare में 502 और 504 एरर: Origin बनाम Edge की पहचान कैसे करें?

यदि आपकी वेबसाइट Cloudflare के माध्यम से चल रही है, तो स्क्रीन पर दिखने वाला डिज़ाइन आपको तुरंत बता देता है कि गलती किसकी है:

1. Cloudflare Branded 502/504 Error: यदि एरर पेज पर Cloudflare का बड़ा लोगो बना है और नीचे एक डायग्राम में "Browser: Working", "Cloudflare: Working" और "Host: Error" दिख रहा है, तो इसका मतलब है कि Cloudflare पूरी तरह स्वस्थ है लेकिन आपकी होस्टिंग कंपनी का सर्वर डाउन है। आपको अपने होस्टिंग प्रोवाइडर से संपर्क करना होगा या सर्वर रीस्टार्ट करना होगा।
2. Plain Text 502/504 Error: यदि स्क्रीन पर बिना किसी लोगो के सादे काले अक्षरों में सिर्फ 502 Bad Gateway (nginx) लिखा है, तो इसका मतलब है कि क्लाउडफ्लेयर ने तो रिक्वेस्ट सही पास कर दी, लेकिन आपके अपने ओरिजिन सर्वर के अंदर Nginx और PHP-FPM का कनेक्शन टूटा हुआ है।
3. Cloudflare 100-Second Hard Limit: ध्यान रखें कि Cloudflare के फ्री टियर पर 100 सेकंड का हार्ड टाइमआउट होता है। यदि आपकी कोई स्क्रिप्ट (जैसे डेटाबेस बैकअप या लंबा CSV इम्पोर्ट) 100 सेकंड से ज्यादा चलती है, तो Cloudflare अपने आप 504 Gateway Timeout फेंक देगा। इसका एकमात्र समाधान यह है कि उस भारी यूआरएल को Cloudflare के 'Page Rules' में जाकर Cache Level: Bypass कर दें या डायरेक्ट ओरिजिन आईपी से एक्सेस करें।

6. PHP-FPM पूल ट्यूनिंग: pm.max_children का रैम-आधारित गणित

502 और 504 एरर्स का सबसे बड़ा अदृश्य कारण है गलत PHP-FPM प्रोसेस सेटिंग्स। जब एक साथ कई यूज़र्स साइट पर आते हैं, तो उपलब्ध प्रोसेस वर्कर्स खत्म हो जाते हैं और नया ट्रैफिक हैंग हो जाता है।

pm.max_children की गणना करने का फॉर्मूला:

1. जांचें कि एक औसत वर्डप्रेस PHP प्रोसेस कितनी रैम खाती है:

   ps --no-headers -o "rss,cmd" -C php-fpm8.2 | awk '{ sum+=$1 } END { printf ("%d MB
   ", sum/NR/1024) }'

   (सामान्य वर्डप्रेस साइट पर एक प्रोसेस औसतन 60MB से 80MB रैम लेती है)।
2. अब देखें कि आपके सर्वर पर PHP के लिए कितनी फ्री रैम उपलब्ध है (उदा. 4GB रैम सर्वर पर OS और MySQL छोड़कर लगभग 2.5GB = 2560MB रैम PHP के लिए बचती है)।
3. कैलकुलेशन: 2560 MB / 70 MB = लगभग 35।
4. अपनी पूल फाइल (/etc/php/8.2/fpm/pool.d/www.conf) खोलें और ये वैल्यूज सेट करें:

   pm = dynamic
   pm.max_children = 35
   pm.start_servers = 8
   pm.min_spare_servers = 4
   pm.max_spare_servers = 12
   pm.max_requests = 1000

5. (यहाँ pm.max_requests = 1000 सेट करने से हर प्रोसेस 1000 अनुरोध पूरे करने के बाद खुद रीसायकल हो जाएगी, जिससे मेमोरी लीक हमेशा के लिए खत्म हो जाती है)।

7. Nginx और Apache एरर लॉग्स की रियल-टाइम जांच (tail -f SOP)

जब साइट 502 या 504 एरर फेंक रही हो, तो सबसे समझदारी भरा कदम यह है कि आप सर्वर के लाइव लॉग्स को अपनी आँखों के सामने बहते हुए देखें:

sudo tail -f /var/log/nginx/error.log

जैसे ही आप अपने ब्राउज़र में साइट को रीफ्रेश करेंगे, टर्मिनल में तुरंत लाल चेतावनी दिखेगी। यदि वहाँ लिखा है "upstream prematurely closed connection while reading response header", तो समझें कि PHP प्रोसेस आउट-ऑफ-मेमोरी होकर क्रैश हो गई है।

8. भारी प्लगइन्स और डेटाबेस डेडलॉक्स को आइसोलेट करना (Query Monitor)

यदि 504 गेटवे टाइमआउट किसी विशिष्ट पेज (जैसे चेकआउट पेज या सर्च रिजल्ट्स) पर बार-बार आ रहा है, तो Query Monitor प्लगइन इंस्टॉल करें:

• यह टूल आपको दिखाता है कि कौन सी MySQL क्वेरी 2 सेकंड से ज्यादा का समय ले रही है (Slow Queries)।
• यदि कोई प्लगइन डेटाबेस की टेबल को 'Lock' कर रहा है, तो MySQL में अन्य सभी विज़िटर्स कतार में फंस जाते हैं और 504 एरर आ जाता है। ऐसे खराब कोड वाले प्लगइन्स को तुरंत हटाएं या उनकी डेटाबेस इंडेक्सिंग ठीक करें।

9. आम गलतियां, बोट स्पाइक्स और सर्वर ओवरलोड से बचाव की SOP

भविष्य में 502 और 504 गेटवे एरर्स से स्थायी सुरक्षा के 3 नियम:

1. Cloudflare Bot Management चालू रखें: दुर्भावनापूर्ण स्क्रेपर्स और बॉट्स सर्वर पर एक साथ 500 रिक्वेस्ट्स भेजकर PHP वर्कर्स को जाम कर देते हैं। Cloudflare में 'Bot Fight Mode' को हमेशा ऑन रखें।
2. सिस्टम क्रॉन (System Crontab) का उपयोग: वर्डप्रेस के डिफ़ॉल्ट wp-cron.php को डिसेबल करें और लिनक्स के सिस्टम क्रॉन से हर 15 मिनट पर बैकग्राउंड जॉब्स चलाएं ताकि विज़िटर्स के पेज लोडिंग पर टाइमआउट का लोड न पड़े।
3. Redis Object Cache: 60% डेटाबेस क्वेरीज को सर्वर की रैम में कैश करने से MySQL पर लोड खत्म हो जाता है और 504 टाइमआउट कभी नहीं आता।

11. Nginx FastCGI बफर सेटिंग्स ट्यूनिंग (Response Buffer Overflow Fix)

कई बार PHP स्क्रिप्ट बिना किसी एरर के पूरी तरह निष्पादित हो जाती है, लेकिन फिर भी Nginx ब्राउज़र को "502 Bad Gateway" लौटा देता है। ऐसा तब होता है जब PHP स्क्रिप्ट बहुत बड़े हेडर (Headers) या कुकीज भेजती है और Nginx का डिफ़ॉल्ट बफर साइज उसे संभालने के लिए छोटा पड़ जाता है। Nginx एरर लॉग में यह लाइन दिखाई देती है:

upstream sent too big header while reading response header from upstream

इस अदृश्य 502 एरर को ठीक करने के लिए अपनी Nginx साइट कन्फिगरेशन फाइल (/etc/nginx/sites-available/yoursite.conf) में location ~ \.php$ ब्लॉक के अंदर निम्न तीन बफर डायरेक्टिव्स जोड़ें:

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    
    # 502 बफर ओवरफ्लो रोकने के लिए बफर साइज बढ़ाएं
    fastcgi_buffer_size 128k;
    fastcgi_buffers 4 256k;
    fastcgi_busy_buffers_size 256k;
    fastcgi_temp_file_write_size 256k;
    
    # टाइमआउट 300 सेकंड पर सेट करें
    fastcgi_read_timeout 300;
    fastcgi_connect_timeout 300;
    fastcgi_send_timeout 300;
}

कन्फिगरेशन सुरक्षित करने के बाद सिंटैक्स जांचें: sudo nginx -t और रीलोड करें: sudo systemctl reload nginx।

12. Cloudflare Error 520, 521, 522 और 524 का विस्तृत समाधान SOP

यदि आपकी वेबसाइट Cloudflare CDN के पीछे काम कर रही है, तो Cloudflare अपने स्वयं के कस्टम 5xx कोड दिखाता है जो सीधे ओरिजिन सर्वर की स्थिति दर्शाते हैं:

1. Cloudflare Error 521 (Web Server is Down): इसका सीधा अर्थ है कि आपके होस्टिंग सर्वर का Apache/Nginx वेब सर्वर बंद है या पोर्ट 80/443 पर क्लाउडफ्लेयर के IP एड्रेस को ब्लॉक कर रहा है। अपने सर्वर के फायरवॉल (UFW/IPTables) में Cloudflare के सभी ऑफिशियल IP सबनेट्स को वाइटलिस्ट करें।
2. Cloudflare Error 522 (Connection Timed Out): इसका अर्थ है कि क्लाउडफ्लेयर ने आपके सर्वर से TCP 3-वे हैंडशेक शुरू किया लेकिन सर्वर ने 15 सेकंड में कोई SYN-ACK जवाब नहीं दिया। यह सर्वर क्रैश होने या नेटवर्क रूटिंग फेलियर का संकेत है।
3. Cloudflare Error 524 (A Timeout Occurred): यह 504 Gateway Timeout का क्लाउडफ्लेयर संस्करण है। जब आपकी वर्डप्रेस स्क्रिप्ट (जैसे बैकअप एक्सपोर्ट या भारी वूकॉमर्स रिपोर्ट) 100 सेकंड से ज्यादा समय लेती है, तो क्लाउडफ्लेयर कनेक्शन काट देता है। क्लाउडफ्लेयर फ्री प्लान पर टाइमआउट 100 सेकंड पर हार्डकोडेड होता है। ऐसी भारी स्क्रिप्ट्स को WP-CLI (कमांड लाइन) से चलाएं या उस सबडोमेन पर क्लाउडफ्लेयर प्रॉक्सी (Orange Cloud) को बाईपास करके Gray Cloud (DNS Only) कर दें।

13. ऑटोमेटेड बैश डायग्नोस्टिक स्क्रिप्ट: 60 सेकंड में सर्वर हेल्थ ऑडिट

जब भी आपकी वेबसाइट पर 502 या 504 एरर आए, तो बिना समय गंवाए अपने लिनक्स VPS टर्मिनल पर यह वन-लाइनर कमांड चलाकर पूरे सिस्टम की स्थिति जांचें:

cat << 'EOF' > /root/check_server_health.sh
#!/bin/bash
echo "=== 1. RAM & SWAP USAGE ==="
free -h
echo -e "
=== 2. CPU LOAD & PROCESS COUNT ==="
uptime
echo -e "
=== 3. PHP-FPM SERVICE STATUS ==="
systemctl status php*-fpm --no-pager | grep "Active:"
echo -e "
=== 4. TOP 5 MEMORY HOGGING PROCESSES ==="
ps aux --sort=-%mem | awk 'NR<=6{print $2, $4, $11}'
echo -e "
=== 5. LAST 10 NGINX ERROR LOGS ==="
tail -n 10 /var/log/nginx/error.log
echo -e "
=== 6. DISK INODES & SPACE ==="
df -h /
df -i /
EOF
chmod +x /root/check_server_health.sh
/root/check_server_health.sh

यह स्क्रिप्ट तुरंत आपको बता देगी कि क्या रैम 100% फुल होने से OOM-Killer ने PHP-FPM को मार दिया था, या डिस्क इनोड्स फुल होने की वजह से सर्वर टेम्प फाइल्स नहीं लिख पा रहा था।

10. People Also Ask (PAA) महत्वपूर्ण प्रश्नोत्तर