Sık kullandığınız bir siteye girmek istediniz ve karşınıza bembeyaz bir sayfada tek satır çıktı: 502 Bad Gateway. Sayfayı yeniliyorsunuz, bazen açılıyor, bazen aynı uyarı geri geliyor. Bu hata, internet bağlantınızın kopuk olduğunu değil, sitenin arka tarafındaki sunucuların birbirleriyle düzgün konuşamadığını gösterir. Aşağıda 502 hatası nedir sorusunu yanıtlıyor, olası nedenleri sıralıyor ve hem ziyaretçilerin hem de site sahiplerinin uygulayabileceği çözümleri adım adım anlatıyoruz.
502 Bad Gateway Ne Demek?
Bir web sayfası çoğu zaman tek bir sunucudan gelmez. Tarayıcınızın isteği önce bir ağ geçidine ya da vekil sunucuya ulaşır; bu sunucu isteği arkadaki asıl uygulama sunucusuna iletir ve aldığı cevabı size geri gönderir. Bad gateway, yani hatalı ağ geçidi, aradaki sunucunun arkadaki sunucudan geçersiz bir cevap aldığı ya da hiç cevap alamadığı anlamına gelir.
502, HTTP durum kodlarının sunucu kaynaklı hataları gösteren 5xx ailesindendir. Sunucu yazılımına ve tarayıcıya göre “502 Bad Gateway”, “Error 502”, “HTTP 502” ya da “502 Proxy Error” gibi farklı biçimlerde görünebilir. Hepsi aynı durumu ifade eder.
502 Bad Gateway Hatası Nedenleri Nelerdir?
- Sunucunun aşırı yüklenmesi: Ani trafik artışı ya da kaynak tüketen bir işlem, uygulama sunucusunun isteklere cevap verememesine yol açar.
- Arka uç servisinin durması: PHP işleyicisi, uygulama sunucusu ya da veritabanı çökmüş ya da yeniden başlatılıyor olabilir.
- Zaman aşımı: Uzun süren bir sorgu ya da betik, ağ geçidinin bekleme süresini aşar.
- Güvenlik duvarı engellemeleri: Yanlış yapılandırılmış bir güvenlik duvarı, sunucular arasındaki iletişimi ya da CDN adreslerini engelleyebilir.
- CDN ya da ters vekil sorunları: Aradaki hizmet, asıl sunucuya ulaşamadığında bu hatayı gösterir.
- DNS sorunları: Alan adı yanlış IP adresine yönlenmiş ya da yeni yapılan bir değişiklik henüz yayılmamış olabilir.
- Hatalı kod, eklenti ya da tema: Özellikle WordPress sitelerde uyumsuz bir eklenti PHP sürecinin çökmesine neden olabilir.
- Tarayıcı tarafındaki sorunlar: Daha seyrek olmakla birlikte, bozuk önbellek ya da bir tarayıcı uzantısı da hataya yol açabilir.
502 Bad Gateway Hatası Çözümleri Nelerdir?
Ziyaretçiler İçin
- Sayfayı yenileyin: Hata çoğu zaman geçicidir. Bir iki dakika bekleyip yeniden deneyin.
- Sitenin genel durumunu kontrol edin: Siteyi başka bir cihazdan ya da mobil veriyle açın. Hiçbir yerde açılmıyorsa sorun site tarafındadır ve beklemek dışında yapabileceğiniz pek bir şey yoktur.
- Gizli pencerede deneyin: Sayfa gizli modda açılıyorsa tarayıcı önbelleğini ve çerezleri temizleyin.
- Uzantıları kapatın: Reklam engelleyici ve vekil uzantılarını geçici olarak devre dışı bırakın.
- DNS önbelleğini temizleyin: Sorun DNS kaynaklıysa bu adım işe yarar. Ayrıntılar için DNS hatalarının çözümü yazımıza bakabilirsiniz.
- Modemi yeniden başlatın: Ağ ekipmanındaki geçici sorunları giderir.
- VPN ya da vekil sunucuyu kapatın: Bu araçlar bağlantıyı farklı bir yol üzerinden geçirdiği için hataya neden olabilir.
Site Sahipleri İçin
- Hata kayıtlarını inceleyin: Sunucunuzun ve uygulamanızın hata günlükleri sorunun kaynağını çoğu zaman doğrudan gösterir.
- Kaynak kullanımına bakın: İşlemci, bellek ve eş zamanlı işlem sınırlarının dolup dolmadığını hosting panelinizden kontrol edin.
- Servisleri yeniden başlatın: Web sunucusu ve PHP işleyicisini yeniden başlatmak, takılı kalmış süreçleri temizler.
- Son değişiklikleri geri alın: Hata bir güncellemeden hemen sonra başladıysa eklentileri devre dışı bırakıp tek tek açın, varsayılan temaya geçerek deneyin.
- CDN’i geçici olarak devre dışı bırakın: Site CDN olmadan açılıyorsa sorun aradaki katmandadır.
- Güvenlik duvarı kurallarını gözden geçirin: CDN ve yük dengeleyici adreslerinin engellenmediğinden emin olun.
- DNS kayıtlarını doğrulayın: Alan adınızın doğru sunucuyu gösterdiğini kontrol edin.
- Hosting firmanıza ulaşın: Paylaşımlı hostinglerde sorun çoğunlukla sunucu tarafındadır ve yalnızca sağlayıcınız çözebilir.
Ağır sayfaların sunucuyu yormasını azaltmak, bu hatanın tekrarlanma olasılığını düşürür. Bunun için WordPress önbellek eklentileri yazımızdaki önerilerden yararlanabilirsiniz. Sorun bir sunucu değişikliğinden sonra ortaya çıktıysa site taşıma adımlarını yeniden gözden geçirmek yararlı olur.
502 Bad Gateway Nginx Hatası Çözümü
Hata sayfasının altında nginx yazıyorsa, Nginx ters vekil olarak çalışıyor ve isteği ilettiği arka uç servisinden cevap alamıyor demektir. Bu servis çoğunlukla PHP-FPM ya da bir uygulama sunucusudur. Kontrol edilmesi gereken noktalar şunlardır:
- Nginx hata günlüğü: Günlükte bağlantının reddedildiğini, soket dosyasının bulunamadığını ya da arka ucun bağlantıyı erken kapattığını belirten satırlar sorunun türünü gösterir.
- PHP-FPM çalışıyor mu: Servisin durumunu kontrol edin, durmuşsa başlatın. Bu işlemler sunucuya yönetici erişimi gerektirir.
- Soket ya da port uyumu: Nginx yapılandırmasındaki fastcgi_pass ya da proxy_pass değeri ile arka uç servisinin dinlediği adres aynı olmalıdır. PHP sürümü yükseltildikten sonra soket yolunun değişmesi sık rastlanan bir nedendir.
- Soket izinleri: Nginx kullanıcısının soket dosyasına erişim yetkisi bulunmalıdır.
- İşçi süreç sınırı: PHP-FPM havuzundaki süreç sayısı yetersiz kaldığında istekler karşılıksız kalır. Sunucunun belleğine uygun biçimde artırılabilir.
- Arabellek ve süre ayarları: Büyük başlık gönderen uygulamalarda arabellek boyutlarının, uzun süren işlemlerde okuma süresi ayarlarının yükseltilmesi gerekebilir.
- Yapılandırmayı sınayın: Değişikliklerden sonra nginx -t komutuyla yapılandırmayı denetleyin, hata yoksa servisi yeniden yükleyin.
Sunucu yönetimi konusunda deneyiminiz yoksa yapılandırma dosyalarını değiştirmeden önce yedek alın ya da hosting sağlayıcınızın teknik desteğinden yardım isteyin.
Sık Sorulan Sorular
502 hatası benim bilgisayarımdan mı kaynaklanıyor?
Çoğunlukla hayır. Bu hata sunucu tarafında oluşur. Site başka cihazlarda ve ağlarda sorunsuz açılıyorsa ancak o zaman kendi tarayıcınıza ve ağ ayarlarınıza bakmanız gerekir.
502 ile 504 hatası arasındaki fark nedir?
502’de ağ geçidi arkadaki sunucudan geçersiz bir cevap almıştır. 504 Gateway Timeout hatasında ise cevap belirlenen süre içinde hiç gelmemiştir. İkisi de sunucular arası iletişim sorununa işaret eder.
502 hatası SEO’yu etkiler mi?
Kısa süreli kesintiler genellikle kalıcı bir etki bırakmaz. Hata saatlerce ya da sık sık tekrarlanırsa arama motorları sayfaları tarayamaz ve bu durum sıralamalara olumsuz yansıyabilir.
