Web sitenize erişmeye çalışırken karşılaştığınız “502 Bad Gateway” hatası, çok yaygın ancak tedirgin edici bir durumdur. Bu hata genellikle sunucu tarafı bir problemden kaynaklanır ve siteye erişimi engeller. Hem teknik bilgisi az olan kullanıcıları hem de web sitesi yöneticilerini kapsayan bu rehberde, 502 hatasının ne olduğuna dair net bir açıklama yapacağız. Ayrıca, hatanın oluşma nedenlerini adım adım inceleyip, hem basit hem de gelişmiş çözümleri paylaşacağız. Böylece “502 hatası nasıl çözülür” sorusunun cevaplarına ulaşacaksınız.

502 Bad Gateway Hatası Nedir?

HTTP 502 Bad Gateway, bir web tarayıcısının isteğini sunucuya ileten geçit sunucusunun (gateway veya proxy) arka uçtaki asıl sunucudan geçerli bir yanıt alamadığını gösteren bir hata kodudur. Türkçeye “Geçersiz Geçit” veya “Kötü Geçit” hatası olarak çevrilebilir. Kısacası tarayıcınızın isteği sunucuya ulaştı, fakat sunucu geri dönmesi gereken doğru veya zamanında cevabı veremedi. Hata mesajı genelde şu şekillerde karşınıza çıkabilir:

• 502 Bad Gateway

• 502 Proxy Error

• 502 Service Temporarily Overloaded

• HTTP Error 502 – Bad Gateway

• 502 NGINX ya da 502 Bad Gateway NGINX

Bu ifadelerin hepsi aynı hata kodunu işaret eder. Örneğin bir site Nginx sunucu yazılımı kullanıyorsa hata mesajında “Bad Gateway NGINX hatası” ifadesini görebilirsiniz. Genel olarak, HTTP 5xx ile başlayan kodlar sunucu kaynaklı sorunları ifade eder. Dolayısıyla 502 hatası da ziyaret edilen web sitesinin bulunduğu sunucular arasındaki iletişim problemlerinden kaynaklanır.

502 Bad Gateway Hatasının Nedenleri

Bir web sitesi genellikle birden fazla sunucu veya hizmetin birlikte çalışmasıyla kullanıcıya içerik sunar. Örneğin veritabanı sunucusu, uygulama sunucusu, web sunucusu gibi bileşenler vardır. “502 Bad Gateway” hatası ise çoğunlukla bu bileşenlerden en az birinin doğru çalışmamasından kaynaklanır. Başlıca nedenler şunlardır:

• Sunucu Yanıt Vermiyor: Hedef sunucu (origin) gelen isteğe yanıt veremiyor olabilir. Sunucu aşırı yük altında olabilir, bakımda olabilir veya çökmüş olabilir. Bu durumda “sunucu yanıt vermiyor” hatasıyla karşılaşabilirsiniz.

• Ağ Geçidi Sorunları: Web sunucunuz ile asıl veri kaynağı (örneğin veritabanı veya uygulama sunucusu) arasındaki ara sunucu veya proxy’da problem olabilir. Ağ geçidi düzgün çalışmadığında 502 hatası oluşur.

• Aşırı Trafik ve Kaynak Tükenmesi: Birden fazla ziyaretçi ya da saldırı sonucu oluşan yüksek trafik, sunucunun kaynaklarını tüketerek cevap veremez hale getirebilir. Bu durumda geçici bir kesinti nedeniyle 502 hatası alınır.

• DNS veya Bağlantı Sorunları: Alan adı (DNS) ayarları yanlış yapılandırılmışsa veya DNS kayıtları doğru çözülemiyorsa, istekler yanlış sunucuya yönlendirilebilir veya hiçbir sunucuya ulaşamayabilir. Bu da kötü cevaplara yol açabilir.

• CDN ve Proxy Hataları: Eğer Cloudflare, Akamai gibi bir CDN (İçerik Dağıtım Ağı) veya başka bir proxy hizmeti kullanıyorsanız, bu hizmetlerde yaşanan kesintiler 502 hatasına neden olabilir. Ücretsiz CDN’lerde zaman zaman bu tür hatalar artış gösterebilir.

• Yazılım/Kod Hataları: Sitenize yeni eklenen bir eklenti, tema veya güncelleme uyumsuzluk çıkarmış olabilir. Ayrıca hatalı PHP kodları ya da sunucu ayarları da geçersiz yanıt döndürmeye yol açar.

• Tarayıcı ve Ağ Cihazı Sorunları: Bazı durumlarda sorun tamamen sizden kaynaklı olabilir. Örneğin tarayıcı önbelleğiniz eski bir 502 hatasını tutuyor ya da modeminizle ilgili geçici bir bağlantı hatası oluşuyor. Bu durumlar da geçici 502 hatalarına neden olabilir.

502 Bad Gateway Hatası Nasıl Çözülür?

Bir “502 Bad Gateway” hatası alındığında endişeye kapılmak yerine öncelikle basit adımları deneyebilirsiniz. Çoğu zaman sorun kısa süreli ve geçicidir. Aşağıdaki yöntemler, teknik bilginiz olmasa bile uygulayabileceğiniz temel çözümlerdir:

• Sayfayı Yeniden Yükleyin: Hata geçici ise tarayıcınızda F5 tuşuna basarak veya yenile butonuna tıklayarak siteyi tekrar yükleyin. Bazen birkaç saniye sonra sorun kendiliğinden düzelebilir.

• Farklı Bir Tarayıcı veya Cihaz Kullanın: Hata sadece kullandığınız tarayıcıdan kaynaklanabilir. Chrome yerine Edge, Firefox, Opera ya da Safari deneyin. Telefon veya tablet ile deneyip fark olup olmadığına bakın.

• Ön Belleği ve Çerezleri Temizleyin: Tarayıcınızın önbelleğinde eski hata sayfaları kalmış olabilir. Tarayıcı geçmişi, önbellek ve çerezleri temizleyerek yeniden deneyin. Temizledikten sonra sayfayı bir kez daha yenileyin.

• İnternet Bağlantınızı Kontrol Edin: Modem veya yönlendiriciyi (router) bir dakika kapatıp açmayı deneyin. Aynı ağda başka cihazlarda veya başka sitelerde internet gidip gitmediğine bakın. Bağlantınızda genel bir sorun varsa farklı bir Wi-Fi ağı veya mobil veri deneyin.

• VPN veya Proxy Kullananlar İçin: Eğer VPN ya da proxy hizmeti kullanıyorsanız, bunları geçici olarak devre dışı bırakın. Bazen VPN sunucusuna veya ara proxy’ye bağlı bir aksaklık 502 hatası verebilir.

• Bir Süre Bekleyin: Eğer hata sitenin trafik kaynaklıysa, birkaç dakika beklemek işe yarayabilir. Ardından tekrar sayfayı yenileyin. Özellikle büyük sitelerde ani trafik artışları varsa 502 kısa süreliğine açılabilir.

Bu adımları uyguladığınız halde 502 Bad Gateway hatası devam ediyorsa, sorun muhtemelen sunucu tarafındadır. Bu durumda site sahibi veya teknik destek ekibiyle iletişime geçmek en doğru adım olacaktır.

Web Sitesi Sahipleri için Çözümler

Sitenizin sahibi ya da yöneticisiyseniz ve kullanıcılarınız 502 hatası alıyorsa, sunucu tarafında yapılabilecek kontroller ve ayarlamalar vardır. Aşağıdaki çözüm yollarını deneyerek sorunu giderebilirsiniz:

• Sunucu Durumunu Kontrol Edin: Web sunucunuz (örneğin Apache, Nginx) ve arka uç servisleriniz (PHP-FPM, veritabanı vb.) çalışır durumda mı? Sunucu kullanım oranlarını inceleyin. Aşırı CPU veya RAM kullanımı varsa, kaynak arttırmayı düşünün veya fazla yükü kaldırın.

• Sunucu Servislerini Yeniden Başlatın: Basit ama etkili bir çözüm olarak web sunucusu (Apache/Nginx) ve uygulama servislerinizi (PHP-FPM, Node.js, vb.) yeniden başlatın. Bazen takılan prosesler bu şekilde temizlenir.

• Güncellemeleri ve Eklentileri Kontrol Edin: Yakın zamanda yeni bir güncelleme veya eklenti yüklediyseniz, bunlar 502 hatasına sebep olabilir. Eklentileri tek tek devre dışı bırakıp yeniden deneyin veya son güncellemeyi geri alın.

• Konfigürasyon Dosyalarını Gözden Geçirin: Nginx veya Apache konfigürasyon dosyalarında yeni eklenen kurallar hatalı olabilir. Herhangi bir syntax hatası ya da eksik parametre olup olmadığını kontrol edin. Özellikle proxy_pass, fastcgi_pass gibi ayarlara dikkat edin.

• Hata Kayıtlarını (Log) İnceleyin: Sunucu logları en önemli ipucunu verir. Nginx için /var/log/nginx/error.log, Apache için /var/log/apache2/error.log gibi dosyalara bakın. PHP uygulaması logları veya CMS logları (örneğin WordPress hata kayıtları) da yardımcı olabilir. Hata kayıtlarında geçen IP, tarih veya anahtar kelimeler sorunun kaynağını gösterir.

• Time-out Sürelerini Uzatın: Büyük yük altındaki sunucular bazen varsayılan sürede yanıt veremez. Nginx’te proxy_read_timeout, PHP-FPM’de max_execution_time sürelerini artırarak zaman aşımı kaynaklı sorunları giderebilirsiniz.

• CDN ve DNS Ayarlarını Kontrol Edin: Eğer Cloudflare, CDN veya yük dengeleyici (load balancer) kullanıyorsanız bu katmanları devre dışı bırakıp test edin. DNS kayıtlarında yeni bir değişiklik yaptıysanız, güncellemelerin tam oturması için gereken süreyi (TTL) bekleyin.

• Güvenlik Duvarı ve Firewall: Sunucunuzda güvenlik duvarı kuralları yanlışsa, bazı isteklere izin verilmiyor olabilir. Güvenlik duvarı (firewall) loglarını inceleyin, IP kısıtlaması veya rate-limit yapılandırmaları varsa gözden geçirin.

• Yedek Sunucu veya Alternatif: Yüksek trafikli zamanlarda yetersiz kalan sunucunuz için geçici bir yedek sunucu veya statik sayfa servisi ayarlayabilirsiniz. Bu sayede gerçek zamanlı yükü azaltarak 502 hatasını önleyebilirsiniz.

Bu adımlar genelde sorunu çözecektir. Özellikle “bad gateway nginx hatası” ifadesini gören Nginx kullanıcıları için Nginx konfigürasyonundaki proxy ayarları ve arka uç (örn. PHP) servisleri önemlidir. Eğer sorun hâlâ devam ediyorsa, barındırma hizmeti aldığınız firma veya sunucu sağlayıcınızla iletişime geçmenizde fayda var.

502 Bad Gateway Çözüm Teknikleri

Eğer temel çözümler yetersiz kalıyorsa veya sorunun kaynağı daha karmaşıksa, aşağıdaki gelişmiş yöntemleri değerlendirebilirsiniz:

• Ağ Trafiğini İzleyin: Sunucuya gelen trafik analiz araçları kullanarak (örneğin Netstat, iftop) anormal istek veya saldırı olup olmadığını kontrol edin.

• Uptime ve Sağlık Kontrolü (Health Check): Dışarıdan erişilebilen bir kontrol aracıyla (örneğin https://downforeveryoneorjustme.com/) sitenizin yayında olup olmadığını test edin. Sunucunuz gerçekten yanıt vermiyorsa bu araçlar bunu gösterir.

• Curl veya Telnet ile Test Edin: Sunucunuza terminalden curl -I http://example.com komutuyla HTTP başlıkları almayı deneyin. “502” yanıt alıyorsanız sorun sunucu tarafındadır. Telnet ile sunucuya belirli portlardan bağlanmayı test etmek de faydalı olabilir.

• Yapılandırma Yedekleri ve Versiyon Kontrolü: Eğer sunucu konfigurasyonları yönetim sistemiyle (örneğin Git) takip ediliyorsa, son değişiklikleri gözden geçirin. Yanlış bir commit 502 hatasına yol açmış olabilir.

• Veritabanı ve Diğer Servisleri Kontrol Edin: Bazen 502 hatası web sunucusu yerine veri tabanı veya benzeri arka plan hizmeti yanıt vermeyince gözükür. Veritabanınızın erişilebilir olduğundan ve performansının iyi durumda olduğundan emin olun.

• Güvenlik Yazılımları ve Anti-DDoS: Kurumsal bir önlem olarak, Web Application Firewall (WAF) veya Anti-DDoS çözümleri bazen meşru trafiği de engelleyebilir. Bu tür bir sisteminiz varsa loglarını inceleyip konfigürasyonu test edin.

• Güncelleme ve Yama Yönetimi: Sunucunuzun işletim sistemi ve tüm yazılımlarını güncel tutun. Bazen bilinen hataları gideren yamalar 502 gibi sorunları önleyebilir.

• Profesyonel Destek Alın: Eğer tüm bu adımlardan sonra çözüm bulamazsanız, konunun uzmanından yardım almayı düşünebilirsiniz. Sunucu mühendisi veya geliştirici ile çalışarak sorunun kaynağını derinlemesine inceleyin.

502 Bad Gateway hatası, web tarayıcınız ile site sunucusu arasındaki kopukluğu gösterir. Hatanın nedeni çoğunlukla sunucunun arka uçtan geçerli bir cevap alamamasıdır. Teknik bilgi seviyesi fark etmeksizin herkesin uygulayabileceği ilk adımlar vardır: sayfayı yenilemek, tarayıcıyı değiştirmek, önbelleği temizlemek gibi. Bu adımlar çoğu kez sorunu çözecektir.

Site yöneticileri ve geliştiriciler için ise sunucu loglarını kontrol etmek, servisleri yeniden başlatmak, güncellemeleri yapmak ve CDN/Proxy ayarlarını gözden geçirmek önemlidir. Sunucu altyapınızda düzenli bakım ve izleme yapmak, 502 gibi hataların önüne geçmeye yardımcı olur. Ayrıca, sitenizin trafiğine uygun kaynak planlaması yapmak (örneğin ihtiyaca göre hosting yükseltme) bu tür hataları azaltır.

Sıkça Sorulan Sorular (SSS)

Q: 502 bad gateway hatası tamamen sunucu hatası mı, benim yapabileceğim bir şey yok mu?
A: Genelde evet, 502 hatası sunucu kaynaklıdır. Ancak öncelikle tarayıcı önbelleğinizi temizlemek veya farklı bir tarayıcıyla denemek gibi basit yöntemleri deneyebilirsiniz. Sorun devam ederse büyük ihtimalle sunucu veya ağ yapılandırmasında bir aksaklık vardır.

Q: 502 hatası anlık mı olur, yoksa sürekli devam edebilir mi?
A: Genellikle 502 hatası geçici bir bağlantı problemidir ve birkaç dakika içinde düzelebilir. Ancak site sık sık bu hatayı veriyorsa, kalıcı bir sorun var demektir ve kök sebebi bulup çözmek gerekir. Uzun süreli 502 hataları SEO’yu da olumsuz etkileyebilir.

Q: Firewall veya antivirüs yazılımı 502 hatası verir mi?
A: Kendi bilgisayarınızdaki firewall, antivirüs veya tarayıcı eklentileri genelde 502 hatasına yol açmaz. Eğer şirket ağı gibi karmaşık bir ağdaysanız, ağ geçidi cihazı (proxy) bu hatayı verebilir. Ev kullanıcıları için genelde geçerli değildir.

Q: Cloudflare kullanırken 502 alıyorum, ne yapmalıyım?
A: Cloudflare proxy’si üzerinden gelen 502 hatasında, önce Cloudflare kontrol panelinde DNS ayarlarınızı kontrol edin. Gri bulut (DNS only) modunda deneyerek hatanın Cloudflare’dan mı yoksa sunucudan mı kaynaklandığını öğrenin. Gerekirse Cloudflare desteğiyle iletişim kurun veya geçici olarak devre dışı bırakın.

Diğer Durum Kodları