Bir web sitesini açarken karşınıza “502 Bad Gateway” yazısı çıkıyorsa, sizinle site arasında çalışan sunuculardan biri diğerinden geçerli bir yanıt alamamıştır. Hata hem ziyaretçileri hem site sahiplerini ilgilendirir. Bu yazıda 502 hatasının ne demek olduğunu, nedenlerini ve çözümlerini sade bir dille anlatıyoruz.
502 Bad Gateway Nedir, Ne Demek?
İnternet üzerinde bir siteye girdiğinizde isteğiniz çoğu zaman tek bir sunucuya gitmez. Arada bir ters vekil sunucu (reverse proxy), yük dengeleyici, CDN ya da Nginx gibi bir ağ geçidi bulunabilir. Bu “gateway” konumundaki sunucu isteği asıl uygulama sunucusuna iletir. Asıl sunucudan geçersiz bir yanıt gelirse ya da hiç yanıt alınamazsa ağ geçidi 502 koduyla “Bad Gateway” hatası verir.
Hata farklı yerlerde farklı biçimlerde görünür: “502 Bad Gateway”, “HTTP Error 502”, “Error 502”, “502 Service Temporarily Overloaded” ya da yalnızca “Bad Gateway” gibi. Hepsinin anlamı özünde aynıdır.
502 Bad Gateway Hatası Nedenleri Nelerdir?
- Sunucu aşırı yüklenmesi: Ani trafik artışı ya da yetersiz kaynak nedeniyle uygulama sunucusu yanıt veremez.
- Uygulama sunucusunun çökmesi: PHP-FPM gibi servislerin durması ya da yeniden başlaması 502’ye yol açabilir.
- Zaman aşımı: İstek çok uzun sürerse ağ geçidi beklemeyi bırakır.
- Hatalı eklenti veya tema: WordPress sitelerinde uyumsuz ya da hatalı kod sunucuyu kilitleyebilir.
- DNS veya ağ sorunları: Sunucular arasındaki bağlantı kopabilir. DNS kaynaklı sorunları dns_probe_finished_nxdomain hatası yazımızda inceledik.
- Güvenlik duvarı kuralları: Güvenlik duvarı ya da CDN, asıl sunucuya gelen istekleri engelliyor olabilir.
- Bakım ve güncelleme: Hosting firmasının yaptığı çalışmalar kısa süreli kesintiye neden olabilir.
502 Bad Gateway Hatası Çözümleri Nelerdir?
Ziyaretçiler için
Hatanın çoğu zaman sunucu tarafında olduğunu bilin; yine de şu adımları deneyebilirsiniz:
- Sayfayı yenileyin: Geçici sorunlar birkaç saniye içinde düzelebilir.
- Birkaç dakika bekleyin: Sunucu yeniden başlıyor olabilir.
- Tarayıcı önbelleğini temizleyin: Eski ya da bozuk veriler soruna yol açıyor olabilir.
- Başka tarayıcı ya da cihaz deneyin: Sorunun size özgü olup olmadığını anlarsınız.
- DNS önbelleğini temizleyin ve modemi yeniden başlatın.
- Site sahibine ulaşın: Sorun sürüyorsa sitenin destek kanalından haber verin.
Site sahipleri için
Kendi sitenizde 502 hatası alıyorsanız önce sunucu günlüklerine bakın; hata mesajı genellikle nedeni gösterir. Ardından şunları kontrol edin:
- Hosting kontrol panelinden sunucu kaynak kullanımına (CPU, bellek) bakın. Limitler aşılıyorsa paket yükseltmek gerekebilir. Benzer bir kaynak sorunu için 509 Bandwidth Limit Exceeded hatası yazımıza bakabilirsiniz.
- WordPress kullanıyorsanız eklentileri tek tek devre dışı bırakarak suçluyu bulun. Panel açılmıyorsa FTP üzerinden eklenti klasörünün adını geçici olarak değiştirebilirsiniz.
- Temayı varsayılan bir temaya çevirip hatanın devam edip etmediğine bakın.
- CDN veya güvenlik duvarı kullanıyorsanız geçici olarak devre dışı bırakıp asıl sunucuya doğrudan erişimi test edin.
- PHP sürümünün eklenti ve temalarla uyumlu olduğundan emin olun.
- Çözemezseniz hosting firmanızın teknik desteğine başvurun.
Düzenli olarak yedek almanız ve değişikliklerden önce test ortamında denemeler yapmanız bu tür sorunların etkisini azaltır. Altyapınızın yeterliliğini gözden geçirmek için hosting seçimi ve önbellek eklentileri yazılarımız da işinize yarayabilir.
502 Bad Gateway Nginx Hatası Çözümü
Sunucunuzda Nginx kullanılıyorsa hatanın nedeni çoğunlukla Nginx ile arkasındaki uygulama (örneğin PHP-FPM) arasındaki iletişimdir. Sunucu yönetimi bilginiz varsa şu noktalara bakabilirsiniz:
- Hata günlüğü: Nginx hata günlüğünde “upstream” ile başlayan satırlar sorunun kaynağını gösterir.
- PHP-FPM durumu: Servisin çalıştığını ve Nginx’in yapılandırmasındaki soket ya da port bilgisinin doğru olduğunu doğrulayın.
- Zaman aşımı değerleri: Uzun süren işlemlerde Nginx’in beklemeyi bırakmaması için ilgili zaman aşımı ayarlarını gözden geçirin.
- Kaynak limitleri: PHP-FPM işlem sayısı yetersizse yoğun trafikte yanıt verilemeyebilir.
- Yapılandırma kontrolü: Değişiklik yaptıktan sonra yapılandırma dosyasını test edip servisi yeniden yükleyin.
Paylaşımlı hostingde bu ayarlara erişiminiz olmayacağından doğrudan destek ekibiyle iletişime geçmek en doğrusudur.
Sık Sorulan Sorular
502 hatası benim internetimden mi kaynaklanıyor? Çoğunlukla hayır. Hata genellikle sunucular arasındaki iletişimden kaynaklanır; yine de başka cihazdan denemek ayırt etmenize yardımcı olur.
502 hatası SEO’yu etkiler mi? Kısa süreli kesintiler genellikle sorun yaratmaz; ancak uzun süren ya da sık tekrarlanan hatalar ziyaretçi kaybına ve tarama sorunlarına yol açabilir.
502 ile 504 arasındaki fark nedir? 502’de ağ geçidi geçersiz yanıt alır; 504’te ise yanıt belirlenen sürede hiç gelmez.
Görsel: zdw / Flickr, CC BY-SA 2.0
