Bir siteye girmeye çalışırken beyaz bir sayfada “502 Bad Gateway” yazısını görmek hem ziyaretçiler hem de site sahipleri için can sıkıcıdır. Peki 502 Bad Gateway nedir? Kısaca, sunucular arasındaki iletişimde bir aksaklık olduğunu bildiren bir HTTP durum kodudur. Bu yazıda 502 hatasının ne anlama geldiğini, nedenlerini ve çözüm yollarını anlatıyoruz.
Bad gateway ne demek sorusunun yanıtı Türkçeye “hatalı ağ geçidi” olarak çevrilebilir. Günümüzde birçok sitede ziyaretçinin isteği doğrudan asıl sunucuya gitmez; önce ağ geçidi ya da vekil (proxy) görevi gören bir sunucuya ulaşır. Bu sunucu isteği arka taraftaki uygulama sunucusuna iletir ve yanıtını bekler. Arka sunucudan geçersiz bir yanıt gelirse ya da hiç yanıt alınamazsa aradaki sunucu ziyaretçiye 502 kodunu döndürür. Error 502 ne demek diye soranlar için özet şudur: Sorun çoğunlukla sizin cihazınızda değil, sitenin sunucu tarafındadır.
502 Bad Gateway Hatası Nedenleri Nelerdir?
502 hatası tek bir sebebe bağlı değildir. En sık karşılaşılan nedenler şunlardır:
- Sunucunun aşırı yüklenmesi: Ani trafik artışı ya da yetersiz kaynak, arka sunucunun yanıt verememesine yol açabilir.
- Uygulama servisinin durması: PHP, veritabanı ya da uygulamayı çalıştıran servis çöktüğünde ağ geçidi geçerli bir yanıt alamaz.
- Hatalı kod, eklenti ya da tema: Özellikle güncelleme sonrasında ortaya çıkan yazılım hataları isteğin yarıda kesilmesine neden olabilir.
- Uzun süren işlemler: Ağır veritabanı sorguları ve büyük dosya işlemleri zaman sınırını aşabilir.
- Güvenlik duvarı engelleri: Sunucudaki güvenlik duvarı, vekil sunucudan gelen istekleri yanlışlıkla engelleyebilir.
- CDN ve vekil servisleri: Araya yerleştirilen içerik dağıtım ağı asıl sunucuya ulaşamadığında 502 Bad Gateway hatası gösterir.
- DNS sorunları: Alan adı yanlış bir IP adresini gösteriyorsa ya da yeni yapılan değişiklik henüz yayılmadıysa hata oluşabilir.
- Tarayıcı ve yerel ağ: Daha seyrek olmakla birlikte bozuk önbellek, eklentiler ya da ağ ayarları da soruna katkıda bulunabilir.
502 Bad Gateway Hatası Çözümleri Nelerdir?
502 Bad Gateway sorunu ile karşılaşan bir ziyaretçiyseniz deneyebileceğiniz adımlar sınırlıdır ama çoğu zaman yeterlidir:
- Sayfayı birkaç dakika sonra yenileyin; geçici yüklenmeler genellikle kendiliğinden düzelir.
- Siteyi gizli sekmede ya da başka bir tarayıcıda açmayı deneyin.
- Tarayıcı önbelleğini ve çerezleri temizleyin.
- Farklı bir cihaz ya da ağ üzerinden kontrol ederek sorunun herkeste olup olmadığını anlayın.
- Modemi yeniden başlatın ve DNS önbelleğini temizleyin.
- VPN ya da vekil sunucu kullanıyorsanız geçici olarak kapatın.
Hata devam ediyorsa beklemek ya da site yönetimine haber vermek dışında yapılacak pek bir şey yoktur.
Site sahibiyseniz şu kontrolleri sırayla yapabilirsiniz:
- Sunucu kayıtlarını inceleyin. Hata günlükleri sorunun hangi serviste başladığını çoğu zaman açıkça gösterir.
- Servisleri kontrol edin. Web sunucusu, PHP ve veritabanı servislerinin çalıştığından emin olun, gerekiyorsa yeniden başlatın.
- Kaynak kullanımına bakın. Bellek ve işlemci sınırına dayanılmışsa paketinizi yükseltmeniz ya da siteyi hafifletmeniz gerekebilir.
- Son değişiklikleri geri alın. WordPress gibi sistemlerde eklentileri devre dışı bırakıp tek tek etkinleştirerek soruna yol açanı bulabilirsiniz. İşlemden önce yedek alın.
- CDN’i geçici olarak devre dışı bırakın. Sorun bu şekilde düzeliyorsa CDN ayarlarını ve sunucu güvenlik duvarındaki izinleri gözden geçirin.
- DNS kayıtlarını doğrulayın. Alan adının doğru sunucuyu gösterdiğinden emin olun.
- Barındırma firmanıza ulaşın. Paylaşımlı sunucularda sorunun kaynağına çoğu zaman yalnızca destek ekibi erişebilir.
502 Bad Gateway Nginx Hatası Çözümü
Hata sayfasının altında “nginx” yazıyorsa yanıtı Nginx web sunucusu üretmiştir. Nginx çoğu kurulumda PHP-FPM gibi bir arka servise ya da başka bir uygulama sunucusuna vekillik yapar. 502 Bad Gateway nginx hatası da genellikle bu arka servise ulaşılamadığını gösterir. Sunucuya erişiminiz varsa şu noktaları kontrol edebilirsiniz:
- Nginx hata günlüğü: Çoğu sistemde
/var/log/nginx/error.logdosyasında bulunur. “connection refused” ya da “no such file or directory” gibi satırlar sorunun yönünü gösterir. - Arka servisin durumu: PHP-FPM ya da uygulama servisinin çalışıp çalışmadığını denetleyin, durmuşsa yeniden başlatın.
- Soket ve port uyumu: Nginx yapılandırmasındaki
fastcgi_passya daproxy_passadresi, arka servisin dinlediği soket veya portla aynı olmalıdır. Sürüm yükseltmelerinden sonra soket yolu değişmiş olabilir. - İşlem ve zaman sınırları: PHP-FPM’in aynı anda çalıştırabildiği işlem sayısı ile zaman aşımı ve tampon ayarları sitenin yüküne göre düzenlenmelidir.
- Yapılandırma testi: Değişiklikten sonra
nginx -tkomutuyla yapılandırmayı sınayın, hata yoksa servisi yeniden yükleyin.
Dosya yolları ve servis adları işletim sistemine ve sürüme göre değişebilir. Emin olmadığınız ayarları değiştirmeden önce yedek almanız ve gerekirse bir sistem yöneticisinden destek istemeniz doğru olur.
Özetle error 502, sunucular arasındaki iletişimin koptuğunu haber verir. Ziyaretçi için çoğu zaman biraz beklemek yeterlidir; site sahibi için ise günlükleri incelemek ve arka servislerin durumunu kontrol etmek sorunu çözmenin en kısa yoludur.
