502 Bad Gateway Hatası Nedir? Nedenleri ve Kesin Çözümü

Kısa cevap: 502 Bad Gateway, isteği karşılayan ara sunucunun (Nginx gibi bir reverse proxy, Cloudflare veya yük dengeleyici) arkadaki asıl uygulamadan geçersiz yanıt aldığını ya da hiç yanıt alamadığını gösteren HTTP hata kodudur. Yani web sunucusu çalışıyordur ama arkasındaki uygulama (PHP-FPM, Node.js, Python) çökmüş, yanıt vermiyor veya yanlış adrese yönlendiriliyordur. Sorun neredeyse her zaman sitenin sunucu tarafındadır.

Ziyaretçiyseniz Ne Yapmalısınız?

• Sayfayı birkaç saniye sonra yenileyin (Ctrl + F5); geçici bir aşırı yükleme olabilir.
• Başka bir tarayıcı veya cihazdan deneyin.
• Tarayıcı önbelleğini temizleyin.
• Sorun devam ediyorsa sitenin sahibine bildirin; çözüm onların sunucusundadır.

Site Sahipleri İçin: 502'nin En Yaygın Nedenleri

Neden	Belirti
Uygulama çöktü / çalışmıyor	Nginx logunda connect() failed (111: Connection refused)
Yanlış upstream adresi veya portu	Uygulama çalışıyor ama Nginx başka porta yönlendiriyor
PHP-FPM durdu veya socket yolu yanlış	WordPress / PHP sitelerinde ani 502
Bellek yetersizliği (OOM)	Uygulama rastgele zamanlarda kapanıyor
Uygulama çok yavaş yanıt veriyor	Yoğun anlarda 502 / 504
Cloudflare kaynak sunucuya ulaşamıyor	Cloudflare markalı 502 sayfası

Adım Adım Çözüm

1. Nginx hata loguna bakın

sudo tail -n 50 /var/log/nginx/error.log

Log, sorunun kaynağını çoğu zaman doğrudan söyler: Connection refused (uygulama kapalı), No such file or directory (yanlış socket yolu), upstream timed out (uygulama yavaş).

2. Arkadaki uygulama çalışıyor mu?

# PHP siteleri (WordPress vb.)
systemctl status php*-fpm

# Node.js (PM2)
pm2 status && pm2 logs --lines 50

# systemd servisi
systemctl status uygulamam

Kapalıysa yeniden başlatın ve neden kapandığını loglardan inceleyin.

3. Upstream adresini doğrulayın

Nginx yapılandırmasındaki proxy_pass veya fastcgi_pass değerinin, uygulamanın gerçekten dinlediği port/socket ile aynı olduğundan emin olun:

sudo ss -tlnp            # hangi süreç hangi portu dinliyor
sudo nginx -t && sudo systemctl reload nginx

Nginx yapılandırma örneği için: Nginx Nedir? Reverse Proxy

4. Bellek yetersizliğini kontrol edin

free -h
sudo dmesg -T | grep -i -E "killed process|out of memory"

"Killed process" satırları görüyorsanız sunucunun RAM'i yetmiyor; işletim sistemi uygulamayı sonlandırıyor. Kalıcı çözüm, uygulamanın bellek kullanımını azaltmak veya sunucu paketini yükseltmektir. Geçici önlem olarak swap alanı eklenebilir.

5. Zaman aşımı ayarları

Uzun süren işlemler (büyük raporlar, içe aktarmalar) için Nginx'in bekleme süresini artırabilirsiniz; ancak asıl çözüm bu işleri arka plana almaktır:

proxy_read_timeout 120s;

6. Cloudflare kullanıyorsanız

Cloudflare'in 502/521/522 sayfaları, Cloudflare'in kaynak sunucunuza ulaşamadığını gösterir. Sunucunun açık olduğunu, güvenlik duvarının Cloudflare IP'lerine izin verdiğini ve SSL modunun doğru olduğunu kontrol edin (bkz. Cloudflare Nedir?).

502, 503 ve 504 Farkı

Kod	Anlamı
502 Bad Gateway	Ara sunucu, arkadaki uygulamadan geçersiz yanıt aldı veya hiç ulaşamadı
503 Service Unavailable	Sunucu geçici olarak hizmet veremiyor (bakım, aşırı yük)
504 Gateway Timeout	Ara sunucu, arkadaki uygulamadan zamanında yanıt alamadı

Tekrarlamaması İçin

• Uygulamayı PM2 veya systemd ile otomatik yeniden başlatılacak şekilde çalıştırın.
• Sunucu kaynaklarını (CPU, RAM) izleyin; sürekli sınırda çalışıyorsa paketinizi büyütün.
• Güncellemelerden önce snapshot alın (bkz. Yedekleme Nedir?).