502 Bad Gateway, ağ geçidi veya proxy olarak çalışan bir sunucunun, isteği yerine getirmek için bağlandığı üst sunucudan (upstream) geçersiz bir yanıt aldığı anlamına gelir. Proxy'nin kendisi çalışıyordur; sorun onun arkasındadır.
Tipik kurulumlarda proxy nginx, Apache, bir yük dengeleyici veya bir CDN'dir; üst sunucu ise PHP-FPM, Node.js, Gunicorn gibi bir uygulama sunucusu veya bir container'dır. “Geçersiz yanıt” reddedilen veya sıfırlanan bir bağlantıyı, yanıtın ortasında yaşanan bir çökmeyi, hatalı biçimlendirilmiş başlıkları ya da proxy'nin arabelleklerinden büyük başlıkları kapsar (nginx bunu “upstream sent too big header” olarak loglar).
Cloudflare'de kaynak sunucu sorunları genellikle 520, 521 veya 522 gibi daha özel kodlar üretir. Cloudflare üzerinden görülen düz bir 502, kaynak sunucunun kendisinden veya Cloudflare ağı içindeki bir sorundan kaynaklanabilir.
Örnek yanıt
HTTP/1.1 502 Bad Gateway
Date: Fri, 06 Nov 2026 10:15:32 GMT
Server: nginx
Content-Type: text/html
Content-Length: 142
Connection: keep-alive
<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx</center>
</body>
</html>SEO ve yönlendirme kontrolü
Diğer 5xx hataları gibi, kısa süreli 502'ler taramayı yavaşlatır ama sayfaları dizinden kaldırmaz; kalıcı 502'ler ise dizinden çıkarılmaya yol açar. 502'ler çoğu zaman aralıklıdır (yeniden başlatılan bir worker, dolan bir havuz); bu nedenle bir URL'yi birkaç kez kontrol edin veya ne sıklıkla başarısız olduğunu görmek için Toplu yönlendirme kontrolü aracını kullanın.
Yaygın nedenler ve kullanım alanları
- Uygulama sunucusu (PHP-FPM, Node.js, Gunicorn) kapalı, yeniden başlatılıyor veya çökmüş.
- Proxy yanlış üst sunucu adresini, portunu veya soketini gösteriyor.
- Üst sunucunun yanıt başlıkları proxy'nin arabelleklerini aşıyor (nginx'te
proxy_buffer_sizeveyafastcgi_buffer_size). - Bir güvenlik duvarı veya güvenlik grubu, proxy'nin arka uca ulaşmasını engelliyor.