Bir web sitesini açmaya çalışırken karşınıza “502 Bad Gateway” yazısı çıktıysa, sayfa sunucusuyla aranızda bir şeylerin ters gittiğini görmüşsünüz demektir. Peki 502 Bad Gateway nedir, bad gateway ne demek ve bu hata nasıl giderilir? Bu yazıda hem ziyaretçilerin hem de site sahiplerinin işine yarayacak şekilde 502 hatasını, nedenlerini ve çözüm yollarını anlatıyoruz.
502 Bad Gateway Nedir?
502 Bad Gateway, HTTP durum kodlarından biridir ve “kötü ağ geçidi” anlamına gelir. Bir sunucu, başka bir sunucudan (genellikle arkadaki uygulama sunucusundan) geçerli bir yanıt alamadığında bu hatayı verir. Yani sorun sizin bilgisayarınızdan çok, sitenin kendi sunucu zincirindeki bir iletişim kopukluğundan kaynaklanır.
Basit bir benzetmeyle: bir restoranda garson (ağ geçidi veya vekil sunucu) mutfağa (arka uç sunucu) sipariş iletir. Mutfak cevap vermezse ya da anlaşılmaz bir cevap dönerse garson müşteriye “mutfaktan sağlıklı yanıt alamadım” der. Siteye göre bu mesaj “502 Bad Gateway”, “Error 502”, “HTTP Error 502”, “502 Proxy Error” ya da “Bad Gateway: The proxy server received an invalid response” gibi farklı biçimlerde görünebilir.
502 Bad Gateway Hatası Nedenleri Nelerdir?
Hata birçok farklı sebepten kaynaklanabilir. En yaygın nedenler şunlardır:
- Sunucu aşırı yüklenmesi: Trafik yoğunluğu ya da kaynak yetersizliği nedeniyle arka uç sunucu istekleri yanıtlayamaz.
- Arka uç servisinin çökmesi: PHP-FPM, uygulama sunucusu veya veritabanı gibi bir servis durmuş ya da yanıt veremiyordur.
- Güvenlik duvarı veya CDN sorunları: Güvenlik duvarı, içerik dağıtım ağı ya da vekil sunucu isteği engelliyor olabilir.
- DNS sorunları: Alan adı yanlış sunucuya yönleniyor ya da yeni yapılan DNS değişikliği henüz yayılmamış olabilir.
- Eklenti, tema ya da kod hataları: Özellikle WordPress gibi sistemlerde uyumsuz bir eklenti sunucuyu kilitleyebilir.
- Zaman aşımı: Arka uç, belirlenen süre içinde yanıt veremez ve ağ geçidi bağlantıyı keser.
Sunucu tarafında kaynak sıkıntısı yaşıyorsanız hosting seçiminiz de önemlidir. Bu konuda en iyi hosting firmaları yazımıza bakabilirsiniz. Sunucu işletim sistemi tarafında kararlılığın önemi için Linux altyapısının web sunucularındaki kararlılığı yazısı da faydalı olacaktır.
502 Bad Gateway Hatası Çözümleri Nelerdir?
Ziyaretçiler için
- Sayfayı yenileyin: Geçici sorunlar birkaç saniye içinde düzelebilir. Birkaç dakika bekleyip yeniden deneyin.
- Tarayıcı önbelleğini ve çerezleri temizleyin: Eski kayıtlar sorunu sürdürüyor olabilir. Gizli pencerede ya da başka bir tarayıcıda açmayı deneyin.
- Başka bir cihaz veya ağ deneyin: Mobil veri ile bağlanarak sorunun sizin ağınızdan kaynaklanıp kaynaklanmadığını anlayabilirsiniz.
- DNS ayarlarını gözden geçirin: DNS önbelleğini temizlemek veya farklı bir DNS kullanmak bazı durumlarda işe yarar. Ayrıntılar için Windows 11 DNS değiştirme rehberine göz atabilirsiniz. Benzer bir bağlantı hatası için DNS_PROBE_FINISHED_NXDOMAIN hatası nedir yazımız da yardımcı olur.
- Siteyle iletişime geçin: Sorun site tarafındaysa yapabileceğiniz fazla bir şey yoktur; site sahibine bildirmek ya da daha sonra tekrar denemek en doğrusudur.
Site sahipleri için
- Sunucu kaynaklarını kontrol edin: İşlemci, bellek ve bağlantı sayısına bakın. Aşırı yüklenme varsa paketi yükseltmeyi düşünün.
- Servisleri yeniden başlatın: Web sunucusu, PHP-FPM ve veritabanı servislerinin çalışıp çalışmadığını doğrulayın, gerekirse yeniden başlatın.
- Günlük kayıtlarını inceleyin: Sunucunun hata günlükleri sorunun kaynağını çoğunlukla açıkça gösterir.
- Eklenti ve temaları devre dışı bırakın: WordPress kullanıyorsanız eklentileri tek tek kapatarak hataya neden olanı bulun. Önbellek eklentileri de bazen çakışma yaratır; en iyi WordPress cache eklentileri yazısında doğru seçim için ipuçları var.
- CDN ve güvenlik duvarını test edin: CDN’i geçici olarak devre dışı bırakıp sorunun kaybolup kaybolmadığına bakın.
- Hosting sağlayıcınıza başvurun: Sorun sunucu altyapısındaysa destek ekibi en hızlı çözümü sunar. Benzer bir kaynak sınırı sorunu için 509 Bandwidth Limit Exceeded hatası çözümü yazımıza da göz atın.
502 Bad Gateway Nginx Hatası Çözümü
Nginx kullanan sitelerde 502 hatası genellikle Nginx’in arka uç servisine ulaşamamasından kaynaklanır. Kontrol edilebilecek başlıca noktalar şunlardır:
- Arka uç servisi çalışıyor mu? PHP-FPM ya da uygulama sunucusu durmuşsa Nginx yanıt alamaz. Servisi başlatıp durumunu kontrol edin.
- Soket veya port eşleşmesi: Nginx yapılandırmasında belirtilen soket yolu ya da port, arka uç servisinin dinlediği adresle birebir aynı olmalıdır.
- Zaman aşımı değerleri: Uzun süren işlemler için okuma ve bağlantı zaman aşımı değerleri yetersizse artırılabilir.
- Yetki ve dosya izinleri: Soket dosyasına Nginx kullanıcısının erişim izni olduğundan emin olun.
- Hata günlüğü: Nginx hata günlüğünde “connect() failed” ya da “upstream timed out” gibi satırlar nedeni gösterir.
- Yapılandırma testi: Değişiklikten sonra yapılandırmayı sınayıp servisi yeniden yükleyin.
Sunucu yapılandırmasında değişiklik yapmadan önce mutlaka yedek alın. Bu işlemlerde emin değilseniz sistem yöneticisinden ya da hosting firmanızın desteğinden yardım almak sorunu büyütmeden çözmenin en güvenli yoludur.
Özetle 502 Bad Gateway hatası çoğunlukla geçicidir ve sunucu zincirindeki bir iletişim sorununa işaret eder. Ziyaretçiler önce yenileme, önbellek temizleme gibi basit adımları denemeli, site sahipleri ise sunucu kaynaklarını, servisleri ve günlükleri kontrol etmelidir.

