502 Bad Gateway, Türkçesiyle “hatalı ağ geçidi”, aracı görevi gören bir sunucunun (ters proxy, CDN, yük dengeleyici) arkasındaki asıl sunucudan geçersiz bir yanıt aldığını bildiren HTTP durum kodudur. Yani tarayıcınız ilk sunucuya ulaşmıştır, ama o sunucu sayfayı üretmesi gereken uygulama sunucusundan düzgün bir cevap alamamıştır. Hata neredeyse her zaman sitenin sunucu tarafındadır; ziyaretçi olarak yapabileceğiniz şey sınırlıdır, site sahibi olarak ise sorunu zincirin hangi halkasında aradığınızı bilmek çözümü hızlandırır.
Bu yazıda 502 hatasının ne demek olduğunu, nasıl oluştuğunu, ziyaretçi ve site sahibi için çözüm adımlarını, 500, 503 ve 504 ile farkını ve Google’ın 502 hatalarını nasıl değerlendirdiğini anlatıyoruz.
502 Bad Gateway ne demek?
HTTP standardını tanımlayan RFC 9110, 502 kodunu şöyle tanımlar: Sunucu, bir ağ geçidi veya proxy olarak çalışırken, isteği yerine getirmek için eriştiği içerideki sunucudan geçersiz bir yanıt almıştır. “Error 502”, “HTTP 502”, “502 Bad Gateway” ve “502 Proxy Error” gibi ifadelerin hepsi aynı durumu anlatır; farklı görünmeleri, hatayı gösteren yazılımın (Nginx, Apache, Cloudflare, bir bulut yük dengeleyicisi) kendi sayfa tasarımından kaynaklanır.
Bunu anlamak için bugün çoğu sitenin tek bir sunucudan oluşmadığını bilmek gerekir. Tipik bir istek şu yolu izler:
- Tarayıcı isteği gönderir.
- Ön taraftaki sunucu (Cloudflare gibi bir CDN, Nginx ters proxy ya da yük dengeleyici) isteği karşılar.
- Uygulama sunucusu (PHP-FPM, Node.js, Python uygulaması vb.) sayfayı üretir, gerekirse veritabanına bağlanır.
- Yanıt aynı yoldan geri döner.
502, ikinci adımdaki sunucunun üçüncü adımdan anlamlı bir HTTP yanıtı alamadığında ortaya çıkar. MDN’in 502 açıklaması da bu kodun, 500 gibi genel bir hata olmakla birlikte, sorunun istek zincirinde nerede olduğunu işaret ettiğini vurgular.
502 hatasının yaygın nedenleri
- Uygulama sunucusu çalışmıyor: PHP-FPM ya da Node.js süreci çökmüş, yeniden başlatılmış veya hiç başlamamıştır. Proxy bağlanmaya çalışır, bağlantı reddedilir ve ziyaretçiye 502 döner.
- Aşırı yük: Ani trafik artışı, yoğun bot taraması ya da ağır bir arka plan işi nedeniyle uygulama sunucusunun süreç havuzu dolar ve yeni isteklere cevap veremez.
- Zaman aşımı ve yarıda kesilen yanıt: Uygulama yanıtı göndermeye başlayıp yarıda keserse (ör. bellek sınırı aşıldığında süreç sonlandırılırsa) proxy eksik ya da bozuk bir yanıt alır.
- Yanlış yapılandırma: Proxy yanlış porta, yanlış sokete ya da yanlış protokole (HTTP yerine HTTPS veya tersi) yönlendiriliyordur. Yeni bir kurulumdan ya da sunucu taşımasından sonra sık görülür.
- Güvenlik duvarı engeli: Kaynak sunucudaki güvenlik duvarı veya güvenlik eklentisi, CDN’in IP adreslerini saldırgan sanıp engelliyordur.
- DNS sorunu: Alan adı eski ya da yanlış bir sunucuyu gösteriyordur; özellikle DNS değişikliğinin hemen ardından görülebilir.
- Dağıtım (deploy) anı: Yeni sürüm yüklenirken uygulama kısa süre kapanır ve bu arada gelen isteklere 502 döner.
Ziyaretçiyseniz 502 hatası nasıl çözülür?
Hata büyük olasılıkla sitenin sunucusundadır, ama sorunun sizin tarafınızda olmadığından emin olmak için şu adımlar yeterlidir:
- Bir dakika bekleyip sayfayı yenileyin. 502 hataları çoğu zaman geçicidir; yeniden başlatılan bir servis ya da biten bir trafik dalgası sonrası site kendiliğinden düzelir.
- Başka bir tarayıcı veya gizli pencere deneyin. Önbellekteki eski bir yanıtın sorun olup olmadığını anlarsınız.
- VPN, proxy ya da güvenlik yazılımını kapatın. MDN de istemci tarafındaki güvenlik duvarı, VPN, proxy ve DNS ayarlarının bu hataya yol açabileceğini, özellikle site başkaları için çalışıyorsa bunların kontrol edilmesi gerektiğini belirtir.
- Farklı bir ağdan deneyin. Wi-Fi yerine mobil veriyle açmak, sorunun ağınızla ilgili olup olmadığını gösterir.
- DNS önbelleğini temizleyin veya modemi yeniden başlatın. Site yakın zamanda sunucu değiştirdiyse eski adres bilgisi sorun çıkarabilir.
Bu adımlardan sonra hata devam ediyorsa beklemekten başka yapabileceğiniz pek bir şey yoktur; sorun büyük olasılıkla sitenin sunucusundadır.
Site sahibiyseniz 502 hatası nasıl giderilir?
1. Hatayı hangi katmanın ürettiğini bulun
İlk soru, 502 sayfasını kimin gösterdiğidir. Hata sayfasında Cloudflare logosu ve “Host: Error” gibi bir şema görüyorsanız, Cloudflare kaynak sunucunuzdan yanıt alamamıştır. Cloudflare’in 502 ve 504 hata rehberi, bu hataların büyük çoğunlukla kaynak sunucudan kaynaklandığını ve bu durumda barındırma sağlayıcınızla iletişime geçmenizi önerir. Düz beyaz bir sayfada “nginx” yazıyorsa hata kendi Nginx sunucunuzdadır.
2. Sunucu günlüklerine bakın
Ters proxy olarak Nginx kullanıyorsanız error.log dosyasında “connect() failed (111: Connection refused) while connecting to upstream” gibi bir satır, uygulama sunucusunun hiç cevap vermediğini; “upstream prematurely closed connection” ise yanıtın yarıda kesildiğini gösterir. Uygulama günlükleri (PHP hata günlüğü, Node.js süreç yöneticisi kayıtları) asıl nedeni çoğu zaman açıkça yazar.
3. Uygulama servisini kontrol edin
PHP-FPM, Node.js ya da uygulamanızı çalıştıran servis ayakta mı? Yeniden başlatmak hatayı geçici olarak giderebilir, ama nedenini (bellek sızıntısı, dolan süreç havuzu, hatalı güncelleme) bulmadan kalıcı çözüm olmaz.
4. Kaynakları ve zaman aşımı ayarlarını inceleyin
CPU, bellek ve disk kullanımı sınırda mı? Uzun süren işlemler (büyük raporlar, toplu içe aktarma, yedekleme) proxy’nin zaman aşımı süresini aşıyor mu? Zaman aşımını artırmak bazen gerekir, ama yavaş sorguyu ya da ağır işlemi düzeltmek daha sağlıklıdır.
5. Son değişiklikleri geri alın
Hata bir eklenti veya tema güncellemesinden, yeni bir kod dağıtımından ya da sunucu yapılandırma değişikliğinden hemen sonra başladıysa, önce o değişikliği geri alıp test edin.
6. Güvenlik duvarı ve DNS’i doğrulayın
CDN kullanıyorsanız CDN’in IP aralıklarının sunucu güvenlik duvarında izinli olduğundan, alan adınızın DNS kaydının doğru sunucuyu gösterdiğinden emin olun.
Barındırma firmanıza başvuracaksanız hatanın başladığı saati, saat dilimini, hatayı veren tam URL’yi ve (Cloudflare kullanıyorsanız) /cdn-cgi/trace çıktısını iletmeniz süreci hızlandırır; Cloudflare de destek taleplerinde bu bilgileri ister.
502, 500, 503 ve 504 farkı
| Kod | Anlamı | Tipik neden |
|---|---|---|
| 500 Internal Server Error | Sunucu beklenmeyen bir durumla karşılaştı | Kod hatası, bozuk yapılandırma, bellek sınırı |
| 502 Bad Gateway | Ağ geçidi, arkadaki sunucudan geçersiz yanıt aldı | Uygulama sunucusu kapalı, bağlantı reddi, yarıda kesilen yanıt |
| 503 Service Unavailable | Sunucu geçici olarak hizmet veremiyor | Planlı bakım, aşırı yük |
| 504 Gateway Timeout | Ağ geçidi, arkadaki sunucudan zamanında yanıt alamadı | Yavaş sorgu, uzun süren işlem, ağ gecikmesi |
502 ile 504 en çok karıştırılan çifttir. MDN’e göre 502’de ağ geçidi bir yanıt almış ama yanıt geçersizdir; 504’te ise hiç yanıt almamıştır. Genel sunucu hatasını 500 Hatası Nedir?, bakım ve aşırı yük durumunu 503 Hatası Nedir? yazılarımızda ayrıntılı anlattık. Sayfa bulunamadığında dönen kod için de 404 Hatası Nedir? yazımıza bakabilirsiniz.
502 hatası SEO’yu etkiler mi?
Kısa süreli ve ara sıra yaşanan bir 502 hatası sıralamanıza kalıcı zarar vermez; uzun süren ya da sık tekrarlanan hatalar ise verir. Google’ın HTTP durum kodlarının Google tarayıcılarını nasıl etkilediğini anlatan sayfasına göre:
- 5xx sunucu hataları, Google tarayıcılarının siteyi taramayı geçici olarak yavaşlatmasına yol açar; sunucu yeniden başarılı yanıt vermeye başladığında tarama hızı kademeli olarak artar.
- 500, 502 ve 503 için Google, tarama hızını sunucu hatası veren URL sayısıyla orantılı olarak düşürür.
- Dizinde bulunan URL’ler hemen silinmez, ancak hata sürerse zamanla dizinden çıkarılır.
Bu yüzden 502’yi fark ettiğiniz anda değil, oluştuğu anda yakalamak önemlidir. Sitenizi dakika bazında kontrol eden bir erişilebilirlik izleme aracı kurun ve Google Search Console’daki Sayfa dizine ekleme raporunda “Sunucu hatası (5xx)” satırını, Tarama istatistikleri raporunda ise ana makine durumunu düzenli kontrol edin. Planlı bir bakım yapacaksanız ziyaretçilere 502 yerine 503 kodlu bir bakım sayfası göstermek, Google’a durumun geçici olduğunu doğru biçimde anlatır.
Sık sorulan sorular
502 hatası benim internetimden mi kaynaklanır?
Çoğu zaman hayır. 502, sitenin sunucuları arasındaki iletişim sorunudur. Site başka cihaz ve ağlardan da açılmıyorsa sorun sizde değildir. Yalnızca sizde görülüyorsa VPN, proxy veya güvenlik yazılımınızı kontrol edin.
502 hatası ne kadar sürer?
Nedenine bağlıdır. Yeniden başlatma veya kısa trafik dalgası kaynaklı hatalar dakikalar içinde geçer; yapılandırma hatası ya da çöken bir servis, biri müdahale edene kadar sürer.
WordPress sitemde 502 hatası alıyorum, ne yapmalıyım?
Önce hatanın bir eklenti veya tema güncellemesinden sonra başlayıp başlamadığına bakın; ardından barındırma panelinizden PHP sürümü ve PHP-FPM durumu ile bellek kullanımını kontrol edin. Paylaşımlı barındırmada sunucu tarafını göremediğiniz için hata saatini ve URL’yi barındırma firmanıza iletin.
Cloudflare 502 hatası Cloudflare’in arızası mı?
Nadiren. Cloudflare’in kendi belgelerine göre bu hatalar çoğunlukla kaynak sunucudan kaynaklanır. Cloudflare’in durum sayfasında bir arıza duyurusu yoksa sorunu kendi sunucunuzda arayın.
Kısaca
502 Bad Gateway, aracı sunucunun arkadaki uygulama sunucusundan geçerli bir yanıt alamadığını gösterir. Ziyaretçi için çözüm çoğunlukla beklemek ve yenilemektir; site sahibi için ise hatayı üreten katmanı bulup günlükleri, servisleri, kaynakları ve son değişiklikleri sırayla kontrol etmek gerekir. Tekrarlayan sunucu hataları taramayı ve dizine eklemeyi etkilediği için kalıcı çözüm önemlidir. Sunucu hatalarını ve taranabilirlik sorunlarını sistemli biçimde ele almak isterseniz teknik SEO hizmetimize göz atabilirsiniz.
