502 Bad Gateway Hatası ve Çözüm Teknikleri

İlk yayın: 2025-10-29

Teknik güncelleme: 22 Ekim 2026. 502 Bad Gateway, ağ geçidi veya proxy olarak çalışan bir sunucunun arka uçtan geçerli yanıt alamadığını bildiren HTTP durumudur. Her 502 aynı nedenle oluşmaz; hata sayfasını hangi katmanın ürettiğini belirlemek çözümün ilk adımıdır. Tanım için MDN 502 açıklamasına bakabilirsiniz.

502, 503 ve 504 ayrımı

502 geçersiz arka uç yanıtını, 504 ağ geçidinin zamanında yanıt alamamasını ifade eder. 503 ise hizmetin isteği o anda karşılayamadığını belirtir. Ürünlerin hata eşlemeleri ve log ayrıntıları değişebilir; yalnızca durum kodundan kesin kök neden çıkarmayın.

Ziyaretçi ne yapabilir?

Bir süre sonra tekrar deneyebilir ve sitenin durum duyurularını kontrol edebilirsiniz. Ödeme veya sipariş gönderimi sonrasında hata aldıysanız aynı işlemi tekrarlamadan önce sonucu doğrulayın; ilk işlem arka planda tamamlanmış olabilir. Tarayıcı değiştirmek veya VPN kullanmak, sunucu tarafındaki arızayı kalıcı olarak çözmez.

Sunucu yöneticisi için inceleme sırası

1. URL, zaman damgası ve varsa istek kimliğini kaydedin; müşteri verisini rapora taşımayın.
2. CDN, reverse proxy ve uygulama katmanlarından hangisinin 502 ürettiğini belirleyin.
3. Arka uç servisinin çalıştığını, doğru port veya soketi dinlediğini ve proxy’nin ona erişebildiğini kontrol edin.
4. Son dağıtım, çöken işlem, bellek yetersizliği, bağlantı sınırı ve hatalı yanıt kayıtlarını karşılaştırın.
5. Proxy yapılandırması ile uygulamanın beklediği protokolü ve TLS doğrulamasını eşleştirin.
6. Düzeltmeden sonra aynı isteği ve temel kullanıcı akışını yeniden deneyin.

Nginx proxy belgesi bağlantı, yanıt ve zaman aşımı ayarlarını ayrı tanımlar. Süreleri veya işçi sayısını ölçmeden artırmak asıl sorunu gizleyebilir.

Yapılmaması gerekenler

Güvenlik duvarını tamamen kapatmayın, izinleri topluca 777 yapmayın ve TLS sertifika doğrulamasını iptal etmeyin. Tüm servisleri kontrolsüz yeniden başlatmak yerine etkilenen bileşeni ve geri dönüş planını belirleyin. Logları silmek teşhis kanıtlarını kaybettirebilir.

Kaynak veya hosting değişikliği gerekir mi?

Önce ölçümle darboğazı belirleyin. Uygulama gereksinimleri mevcut sınırları aşıyorsa bulut sunucu veya kiralık fiziksel sunucu seçeneklerini değerlendirin. Taşıma gerekiyorsa hosting geçişi öncesinde yapılandırma uyumluluğunu kontrol edin. Daha büyük sunucu, hatalı proxy ayarını kendiliğinden düzeltmez.