HTTP hatası 502: ne anlama gelir ve nasıl düzeltilir

HTTP hatası 502, aradaki bir sunucunun asıl sunucudan hatalı yanıt aldığı anlamına gelir

HTTP 502 hatası, yani 'Bad Gateway', eriştiğiniz sunucunun yalnızca bir aracı olduğunu ve arkasındaki sunucunun geçersiz bir yanıt verdiğini ya da kullanılabilir hiçbir yanıt vermediğini gösterir. Aracı sunucu (Nginx, Apache, Cloudflare, bir AWS yük dengeleyici) sorunsuz çalışıyor; sorun arkasındaki sistemde.

Kod 5xx ailesinde olduğu için tanım gereği sunucu tarafında bir hatadır. 500'den daha nettir: hatanın ağ geçidi ile uygulama sunucusu arasındaki aktarım noktasında oluştuğunu söyler. MDN'in başvuru sayfası (22 Haziran 2026'da güncellendi), kaynak sunucu düzgün bir HTTP hatası göndermiş olsaydı ağ geçidinin bunu iletmesi gerektiğini ekler; 502 ise ağ geçidinin iletecek düzgün bir yanıtı olmadığı anlamına gelir.

Tarayıcıda '502 Bad Gateway' yazan sade beyaz bir sayfa olarak, bir uygulamanın hata kutusunda 'HTTP error! status: 502' olarak, Zoom'da, oyunlarda veya borsa uygulamalarında ise ayrıntıların arasına gizlenmiş 502 ile genel bir 'sunucu hatası' olarak karşınıza çıkar. Anlamı her seferinde aynıdır: hizmetin arka ucu kendi ön kapısına yanıt vermedi.

Sunucu, ağ geçidi veya proxy olarak çalışırken isteği yerine getirmeye çalışırken eriştiği gelen sunucudan geçersiz bir yanıt aldı.

RFC 9110, Authgear'ın 502 sayfasında alıntılandığı şekliyle

İstek bir ağ geçidinden geçer ve 502 tam orada ortaya çıkar

502'yi ortadaki durak verir: tarayıcınız bir ağ geçidiyle (ters proxy, CDN veya yük dengeleyici) konuşur, ağ geçidi uygulama sunucusuyla konuşur ve bu son adım başarısız olduğunda ağ geçidi 502 döndürür.

Authgear'ın sayfası son adımın başarısız olduğu dört durumu sıralar: uygulama sunucusu çalışmıyordur, bağlantıyı beklenmedik şekilde kapatır, bozuk bir HTTP yanıtı döndürür ya da ağ geçidinin zaman aşımı süresinden uzun sürer. Dördünde de ağ geçidinin iletecek geçerli bir yanıtı yoktur, bu yüzden kendi kısa hata sayfasını oluşturur ve onu gönderir.

Hata sayfasındaki marka, hangi aracının pes ettiğini gösterir. Cloudflare görünümlü bir 502, Cloudflare'in sitenin kaynak sunucusundan düzgün bir yanıt alamadığı anlamına gelir. Altta 'nginx' veya 'openresty' yazan sade bir sayfa ise sitenin kendi proxy'sinin aynı makinedeki ya da ağdaki kendi uygulamasına ulaşamadığı anlamına gelir.

502, 503 ve 504, aynı ağ geçidinden çıkan üç farklı durumdur

502, arka uç sunucunun hatalı bir yanıt verdiği anlamına gelir. 503, hizmetin bilerek kullanıma kapatıldığını veya aşırı yüklendiğini gösterir. 504 ise ağ geçidinin süresi dolmadan arka uçtan hiç yanıt gelmediği anlamına gelir.

Bu ayrım önemlidir, çünkü yapmanız gereken şey buna göre değişir. 503 hatası çoğu zaman bir Retry-After ipucuyla gelir ve belirli bir süre sonra kendiliğinden geçer. 504 yavaşlığa işaret eder, bu yüzden çözüm beklemek veya zaman aşımı ayarını değiştirmektir. 502 ise bir çökmeye, yanlış bir porta ya da bozuk bir yanıta işaret eder ve bunun için sunucu tarafında birinin müdahale etmesi gerekir.

Ziyaretçi olarak HTTP hatası 502 görürseniz ne yapmalısınız

Kısa bir ara verdikten sonra sayfayı bir kez yenileyin, ardından aynı sayfayı başka bir ağdan deneyin. İkisinde de açılmıyorsa site çalışmıyordur ve cihazınızdaki hiçbir ayar bunu değiştirmez.

Çoğu kullanıcının 502 hatasının nedenini gereğinden fazla araştırdığını düşünüyoruz. Dürüst tavsiyemiz, herhangi bir ayara dokunmadan önce üç dakika beklemenizdir; çünkü sitenin tarafında çöken bir işlem genellikle bu sürede kendi izleme sistemi tarafından yeniden başlatılır. Aşağıdaki adımlar, hatanın cihazınızdan veya ağınızdan kaynaklandığı az sayıdaki durum içindir.

1. Kısa bir süre bekleyip sayfayı yenileyin

   Otuza kadar sayın ve sayfayı yenileyin. Yeniden başlayan bir arka uçtan gelen 502 hatası çoğu zaman ikinci veya üçüncü denemede geçer.

2. Başka bir ağ deneyin

   Aynı adresi telefonunuzda mobil veriyle açın. 502 hatası orada da çıkıyorsa sorun gidermeyi bırakın: sorun sitededir.

3. DNS önbelleğinizi temizleyin

   Windows'ta Terminal'i yönetici olarak açın ve önce ipconfig /flushdns, ardından netsh winsock reset komutunu çalıştırın; Microsoft topluluğunun 20 Nisan 2026 tarihli yanıtı da bunu öneriyor. Eski bir DNS kaydı sizi artık sağlıklı çalışmayan bir ağ geçidine yönlendirebilir.

4. VPN sunucusunu değiştirin veya test için VPN'i kapatın

   VPN kullanıyorsanız farklı bir ülkeden sunucu seçin ve sayfayı yenileyin. Sonuç değişirse sorun cihazınızda değil, tek bir uç konumdadır. İhtiyacınız varsa işiniz bitince VPN'i tekrar açın.

5. Sitenin durum sayfasına veya sosyal medya hesabına bakın

   Büyük hizmetler kesintileri dakikalar içinde duyurur. "İnceleniyor" yazıyorsa sekmeyi kapatın ve daha sonra tekrar gelin.

6. Çerezleri yalnızca o site için temizleyin

   Nadir görülür ama bozulmuş bir oturum çerezi, kimlik doğrulama ağ geçidinin isteği reddedip 502 döndürmesine neden olabilir. Tarayıcınızın tamamını değil, yalnızca ilgili alan adının çerezlerini temizleyin.

Siteyi siz yönetiyorsanız, üç düzeltme 502 hatalarının çoğunu giderir

Çöken upstream sunucuyu yeniden başlatın, proxy'yi doğru porta yönlendirin ve proxy okuma zaman aşımı süresini artırın: Authgear'a göre on durumdan dokuzunda neden bu üçünden biridir.

Bu üçünün dışında sık rastlanan nedenler şunlardır: sağlık kontrolleri tüm arka uç sunucularını sağlıksız olarak işaretlemiş bir yük dengeleyici, upstream için eski bir DNS yanıtını önbelleğe almış bir proxy, proxy ile upstream arasında başarısız olan bir TLS el sıkışması ya da belleği veya çalışan işlemleri tükenen bir upstream. Bunların her biri proxy'nin hata günlüğüne bir satır bırakır, bu yüzden yapılandırmayı değiştirmeden önce o günlüğü okuyun.

1. Uygulamanın dinlediğinden emin olun

   Sunucuda ss -tlnp | grep <port> komutunu çalıştırın. Proxy'nin beklediği portta hiçbir şey dinlemiyorsa uygulamayı başlatın ve neden durduğunu günlüklerden okuyun.

2. Proxy'nin hedefini kontrol edin

   Nginx'te proxy_pass'e, Apache'te ProxyPass'e bakın. Yanlış port, yanlış soket yolu ya da uygulama https:// kullanırken http:// yazılması neredeyse kesin olarak 502 hatasına yol açar.

3. Zaman aşımı sürelerini gerçek yanıt süreleriyle karşılaştırın

   Uygulama yalnızca yavaşsa proxy_read_timeout (Nginx) veya ProxyTimeout (Apache) değerini artırın, ardından zaman aşımı bir hatayı gizlemesin diye yavaş çalışan uç noktayı profilleyin.

4. curl ile proxy sunucusundan yeniden oluşturun

   Aynı makineden çalıştırılan curl -v http://127.0.0.1:<port>/ komutu, upstream'in hiç yanıt verip vermediğini ve başlıklarının geçerli HTTP olup olmadığını gösterir.

5. Yük dengeleyicinin sağlık durumuna bakın

   AWS ALB, Kubernetes Ingress veya benzeri yapılarda, sağlıklı arka ucu olmayan bir hedef grubu herkese 502 döndürür. Sağlık kontrolü yolunu veya uygulamanın hazır olma yanıtını düzeltin.

VPN nadiren 502 hatasına neden olur, ancak tek bir çıkış sunucusu sizi sorunlu bir uç sunucuya yönlendirebilir

VPN tek başına 502 hatası üretmez; MDN, VPN'leri ve diğer özel ağ kurulumlarını yalnızca site başka herkes için çalışıyorsa kontrol etmeye değer bir istisna olarak listeler.

Sunucu değiştirmenin bazen işe yaramasının nedeni şu: Büyük siteler, çıkış IP adresinize en yakın CDN uç noktasından yanıt verir. Bu uç noktada ya da kaynağa dönen yolunda bir sorun varsa, o çıkıştan ayrılan herkes 502 görür; başka yerlerdeki kişiler ise siteyi normal şekilde gezer. Başka bir ülkeden sunucu seçmek sizi farklı bir uç noktaya yönlendirir; bu meşru bir testtir, bir numara değil. Hangi çıkışta olduğunuzu değişiklikten önce ve sonra tealvpn.com/what-is-my-ip adresinden doğrulayabilirsiniz.

Fxolio LLC tarafından geliştirilen Teal VPN'in Free planı (günde 500 MB) ve Pro planı vardır; Android, Windows, Mac, Linux, Android TV ve Chromebook için uygulamaları bulunur ve Kasım 2026 itibarıyla 14 ülkede sunucuları vardır. Teal Secure her bağlantıda ve her planda açıktır: VPN trafiğini gizler ve bir ağ bir yolu kapattığında uygulama kendi başına başka yollar dener. Bu, VPN'leri kısıtlayan ağlarda işe yarar; 502 için ise bir faydası olmaz, çünkü 502 sitenin kendi arka ucunun arızalanmasıdır. Hiçbir VPN'in her ağda bağlanacağı garanti edilemez ve hiçbir VPN başkasının sunucusunu onaramaz.

• VPN'i suçlamadan önce: VPN kapalıyken, aynı ağda 502 hatası görünüyor mu?
• İkinci bir sunucu ülkesinde de görünüyor mu?
• Hata sayfasında sitenin değil de bir CDN'in adı (Cloudflare, Fastly) yazıyor mu?
• Ağınızın dışındaki bir arkadaşınız aynı dakika içinde aynı hatayı aldı mı?

Site sahipleri, sağlık kontrolleri ve gerçekçi zaman aşımı süreleriyle tekrarlayan 502 hatalarını önler

Tekrarlayan 502 hataları, proxy uygulamanın gerçek durumunu bildiğinde durur: sağlık kontrolünün çağırdığı bir hazır olma uç noktası, çökme durumunda uygulamayı yeniden başlatan bir süreç yöneticisi ve tahmine göre değil, ölçülen yanıt sürelerine göre belirlenmiş bir proxy zaman aşımı.

Bir de iki alışkanlık işe yarar. Proxy'nin upstream için tuttuğu DNS önbelleğini kısa tutun; böylece yeni bir adrese yapılan dağıtım proxy'yi eski adreste bırakmaz. Ayrıca yalnızca CPU veya bellek için değil, 502 sayısının kendisi için de uyarı kurun; çünkü yanlış bir proxy_pass satırı sıfır yük ve yüzde yüz hata oranı oluşturur.

Okumaya devam edin

• Proxy ile VPN: gerçekte hangisine ihtiyacınız var
• Google DNS ile sağlayıcınızın DNS'i: ne değişir ve DNS neleri gösterir
• DNS sızıntı testi: nasıl yapılır ve sonuç ne anlama gelir
• Hangi çıkış IP'sini kullandığınızı kontrol edin

Kaynaklar

• 502 Bad Gateway - HTTP | MDN
• HTTP 502 Bad Gateway: Causes & Fixes | Authgear
• how do you get 502 - Microsoft Q&A

Teal ile ilgili yardıma mı ihtiyacınız var? Destek ekibiyle iletişime geçin.

Sorular