502 Bad Gateway ne demek? 502 Bad Gateway, bir sunucunun gateway veya proxy olarak çalışırken bağlantı kurduğu üst sunucudan (upstream) geçerli bir yanıt alamadığını belirten HTTP sunucu hata kodudur. Sorun çoğunlukla web sitesinin sunucu, reverse proxy, uygulama sunucusu, PHP-FPM, CDN veya ağ yapılandırması tarafındadır.
502 Bad Gateway Nedir?
HTTP 502 Bad Gateway, 5xx sınıfında yer alan bir sunucu hata kodudur. RFC 9110’a göre bu yanıt, bir sunucunun gateway veya proxy olarak çalışırken isteği tamamlamak için eriştiği upstream sunucudan geçerli bir yanıt alamadığını ifade eder.
Basit bir örnekle:
Ziyaretçi → CDN / Nginx / Proxy → Uygulama veya Origin SunucuOrtadaki gateway/proxy sunucu arka taraftaki sunucudan beklediği geçerli yanıtı alamazsa kullanıcıya 502 Bad Gateway dönebilir.
HTTP standardındaki teknik tanımı RFC 9110 – 502 Bad Gateway bölümünden inceleyebilirsiniz.
Bad Gateway Ne Demek?
Bad Gateway Türkçede “Hatalı Ağ Geçidi” şeklinde ifade edilebilir. Buradaki gateway, kullanıcının isteği ile asıl uygulama veya origin sunucu arasında bulunan ara sunucudur.
Dolayısıyla “502 Bad Gateway” mesajı genellikle “bilgisayarınız bozuk” anlamına gelmez. İstek sunucu zincirinde bir noktaya kadar ulaşmıştır ancak ara sunucu, üst sunucudan işlemi tamamlayabileceği geçerli cevabı alamamıştır.
502 Bad Gateway Hatası Nasıl Görünebilir?
Kullanılan web sunucusu, CDN veya servis sağlayıcıya göre aynı hata farklı metinlerle gösterilebilir:
- 502 Bad Gateway
- HTTP 502
- HTTP Error 502
- 502 Proxy Error
- 502 Server Error
- 502 Bad Gateway nginx
- Error 502
- Bad Gateway
502 Bad Gateway Hatası Neden Olur?
502 hatasının tek bir nedeni yoktur. Ortak nokta, gateway veya proxy ile arka taraftaki servis arasında sağlıklı bir yanıt alışverişi kurulamamasıdır.
| Neden | Açıklama |
|---|---|
| Upstream servis çalışmıyor | PHP-FPM, Node.js, Python uygulaması veya başka bir backend servis durmuş olabilir. |
| Sunucu aşırı yük altında | CPU, RAM veya bağlantı kapasitesi tükenmiş olabilir. |
| Reverse proxy yapılandırması | Nginx, Apache veya load balancer yanlış porta ya da socket’e bağlanıyor olabilir. |
| Ağ problemi | Proxy ile origin/upstream arasındaki bağlantı kurulamayabilir veya kesilebilir. |
| Firewall / güvenlik kuralı | Origin sunucu CDN veya proxy IP’lerinden gelen istekleri engelliyor olabilir. |
| DNS / origin IP sorunu | CDN veya proxy artık doğru origin sunucuyu işaret etmiyor olabilir. |
| Uygulama çökmesi | PHP, WordPress eklentisi, tema veya başka bir backend işlemi bağlantıyı beklenmedik biçimde sonlandırabilir. |
| CDN veya proxy problemi | Cloudflare gibi ara servis ile origin arasındaki iletişim başarısız olabilir. |
Ziyaretçiyseniz 502 Bad Gateway Nasıl Düzeltilir?
502 çoğunlukla sunucu tarafında olduğu için ziyaretçinin çözebileceği alan sınırlıdır. Yine de sorunun geçici veya yerel olup olmadığını anlamak için birkaç kontrol yapılabilir.
1. Birkaç Dakika Sonra Tekrar Deneyin
Geçici sunucu yükü, yeniden başlatılan bir backend servisi veya kısa süreli ağ problemi nedeniyle 502 oluşmuş olabilir. Sayfayı sürekli yenilemek yerine kısa süre bekleyip tekrar deneyin.
2. Sitenin Başka Cihazlarda Açılıp Açılmadığını Kontrol Edin
Aynı site başka bir cihazda veya farklı internet bağlantısında açılıyorsa sorun VPN, proxy, kurumsal ağ veya yerel ağ yapılandırmanızla ilişkili olabilir.
Ancak aynı 502 hatası herkeste görülüyorsa tarayıcı önbelleğini temizlemek veya modem sıfırlamak genellikle asıl problemi çözmez; müdahale site sahibi veya hosting tarafında yapılmalıdır.
3. VPN veya Özel Proxy Kullanıyorsanız Kontrol Edin
MDN, hizmet diğer ziyaretçiler için çalışırken istemci tarafında özel ağ, VPN veya benzeri bağlantı yapılandırmalarının istisnai olarak soruna dahil olabileceğini belirtiyor.
VPN kullanıyorsanız geçici olarak devre dışı bırakıp tekrar test edebilir veya farklı bir bağlantı kullanabilirsiniz.
Site Sahibiyseniz 502 Hatasını Nasıl Çözebilirsiniz?
Site sahibinin ilk amacı hatanın hangi katmanda üretildiğini bulmak olmalıdır. Rastgele cache temizlemek veya servisleri yeniden başlatmak yerine istek zincirini adım adım kontrol edin.
1. 502’yi Hangi Sunucunun Ürettiğini Belirleyin
Önce yanıt başlıklarını, hata sayfasını ve sunucu loglarını inceleyin. Hata şu katmanlardan birinde üretilebilir:
Kullanıcı
↓
Cloudflare / CDN
↓
Nginx / Apache / Load Balancer
↓
PHP-FPM / Node.js / Uygulama
↓
Veritabanı veya diğer servislerDoğru katmanı belirlemeden yapılan değişiklikler sorunu gizleyebilir veya teşhisi zorlaştırabilir.
2. Sunucu ve Uygulama Loglarını Kontrol Edin
502’nin gerçekleştiği saat ile log kayıtlarını eşleştirin. Özellikle şunları kontrol edin:
- Nginx error log,
- Apache error log,
- PHP-FPM logları,
- uygulama logları,
- hosting kontrol panelindeki hata kayıtları,
- Cloudflare veya kullanılan CDN’in 5xx logları.
Hata aralıklı oluşuyorsa tarih, saat, saat dilimi ve hatayı üreten URL’yi kaydetmek özellikle önemlidir.
3. Upstream Servisin Çalıştığını Kontrol Edin
Nginx veya başka bir reverse proxy, isteği PHP-FPM ya da farklı bir uygulama sunucusuna iletiyorsa upstream servisin gerçekten çalıştığını ve beklenen port veya Unix socket üzerinde dinlediğini doğrulayın.
Örneğin Nginx doğru PHP-FPM socket’ini bulamıyorsa veya backend servis durmuşsa proxy geçerli cevap alamayabilir.
4. CPU, RAM ve Bağlantı Kapasitesini Kontrol Edin
Sunucunun kaynakları tükeniyorsa backend istekleri karşılayamayabilir. CPU kullanımı, RAM, swap, disk durumu, process sayısı, eşzamanlı bağlantılar ve PHP-FPM worker kapasitesi kontrol edilmelidir.
Yalnızca limitleri artırmak yerine önce hangi sürecin kaynak tükettiğini belirlemek daha sağlıklı bir çözümdür.
Nginx 502 Bad Gateway Hatası Nasıl Çözülür?
Nginx çoğu kurulumda reverse proxy veya FastCGI gateway olarak çalışır. Arkadaki PHP-FPM ya da uygulama sunucusuyla bağlantı kuramadığında 502 hatası görülebilir.
Nginx kullanan bir sunucuda şu kontrolleri yapın:
proxy_passveyafastcgi_passhedefinin doğru olduğundan emin olun.- Backend servisin çalıştığını kontrol edin.
- Port veya socket yolunun doğru olduğunu doğrulayın.
- Nginx error log içerisindeki upstream hatalarını inceleyin.
- Firewall’ın yerel veya uzak upstream bağlantısını engellemediğini kontrol edin.
- Sunucu kaynaklarının tükenmediğini doğrulayın.
Nginx’in resmi upstream modülü dokümanında da uygun upstream sunucunun seçilememesi gibi koşullarda 502 yanıtı üretilebildiği belgelenmektedir.
Cloudflare 502 Bad Gateway Hatası
Cloudflare kullanan sitelerde 502 hatasının iki temel kaynağı olabilir: origin sunucu veya Cloudflare tarafı.
Cloudflare’ın güncel destek dokümanına göre 502/504 hatalarının en yaygın kaynağı origin web sunucusudur. Sunucu yükü, uygulamanın çökmesi, ağ bağlantısı veya engellenen istekler incelenmelidir.
Cloudflare kullanıyorsanız şu bilgileri kaydedin:
- hatanın görüldüğü tam URL,
- tarih ve saat,
- saat dilimi,
- Cloudflare Ray ID varsa Ray ID,
- origin loglarındaki aynı zamana ait kayıtlar.
Güncel açıklama için Cloudflare 502/504 sorun giderme rehberini inceleyebilirsiniz.
WordPress’te 502 Bad Gateway Hatası
WordPress sitesindeki bir 502 hatası doğrudan WordPress çekirdeğinden gelmek zorunda değildir. PHP-FPM, web sunucusu, hosting kaynakları, eklenti veya tema kaynaklı PHP işlemleri ya da CDN/reverse proxy katmanı probleme dahil olabilir.
Eklenti veya Tema Değişikliğini Kontrol Edin
Hata yeni bir eklenti, tema veya kod değişikliğinden hemen sonra başladıysa son değişikliği geri alarak test edin. Mümkünse işlemleri doğrudan canlı site yerine staging/yedek ortamında gerçekleştirin.
WordPress Debug Log Kullanımı
WordPress’in kendi hata kayıtlarını incelemek için geçici olarak aşağıdaki yapı kullanılabilir:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Bunun sonucunda WordPress kaynaklı hata ve uyarılar wp-content/debug.log dosyasına yazılabilir.
Resmi kullanım ayrıntıları için WordPress Debugging dokümanını inceleyebilirsiniz.
PHP-FPM 502 Bad Gateway Hatası
WordPress ve diğer PHP tabanlı sitelerde Nginx ile PHP-FPM arasındaki iletişim problemi sık rastlanan 502 senaryolarından biridir.
Kontrol edilmesi gereken başlıca alanlar şunlardır:
- PHP-FPM servisinin çalışıp çalışmadığı,
- Nginx’in doğru socket veya porta bağlanıp bağlanmadığı,
- PHP-FPM worker kapasitesinin tükenip tükenmediği,
- PHP işlemlerinin beklenmedik biçimde çöküp çökmediği,
- RAM veya sistem kaynaklarının yetersiz kalıp kalmadığı.
Bu kontroller sunucu erişimi gerektirir. Shared hosting kullanıyorsanız ilgili log ve servis bilgilerini hosting sağlayıcınızdan isteyin.
502 ile 504 Arasındaki Fark Nedir?
502 ve 504 birbirine benzese de aynı hata değildir.
| Hata | Anlamı |
|---|---|
| 502 Bad Gateway | Gateway/proxy upstream sunucudan geçerli bir yanıt alamadı. |
| 504 Gateway Timeout | Gateway/proxy upstream sunucudan zamanında yanıt alamadı. |
MDN ve HTTP standardı bu ayrımı açık biçimde yapar: upstream geçersiz yanıt verirse 502, gerekli yanıt zamanında gelmezse 504 kullanılabilir.
504 problemi yaşıyorsanız 504 Gateway Timeout hatası çözümü rehberimizi inceleyebilirsiniz.
502 ile 503 Arasındaki Fark Nedir?
| Hata | Anlamı |
|---|---|
| 502 Bad Gateway | Gateway veya proxy upstream’den geçerli yanıt alamıyor. |
| 503 Service Unavailable | Sunucu geçici olarak isteği karşılayamıyor; örneğin bakım veya aşırı yük nedeniyle. |
503 hakkında ayrıntılı bilgi için 503 Service Unavailable hatası rehberimize geçebilirsiniz.
502 ile 500 Arasındaki Fark Nedir?
500 Internal Server Error genel bir sunucu iç hatasıdır. 502 ise hata zincirinin gateway/proxy ile upstream arasındaki noktada oluştuğunu daha spesifik biçimde ifade eder.
502 Bad Gateway Hatası SEO’yu Etkiler mi?
Kısa süreli ve nadiren görülen tek bir 502 yanıtı doğrudan “SEO cezası” anlamına gelmez. Ancak 502 ve diğer 5xx hatalarının sık veya uzun süreli olması Google’ın siteyi taramasını etkileyebilir.
Google’ın resmi tarama dokümanına göre 5xx sunucu hataları Googlebot’un tarama hızını geçici olarak azaltmasına neden olur. Daha önce dizine eklenmiş URL’ler bir süre korunabilir; ancak sürekli 5xx döndüren URL’ler zaman içinde dizinden çıkarılabilir.
Bu nedenle 502 hatası özellikle önemli sayfalarda düzenli olarak oluşuyorsa yalnızca kullanıcı deneyimi problemi olarak görülmemeli, sunucu kararlılığı açısından da çözülmelidir.
Google’ın güncel açıklaması için Google HTTP durum kodları dokümanını inceleyebilirsiniz.
502 Hatası Tarayıcı Önbelleğinden Kaynaklanır mı?
Gerçek bir 502 Bad Gateway hatasının temel nedeni çoğunlukla tarayıcı önbelleği değildir. Çünkü 502, gateway/proxy ile upstream arasındaki sunucu iletişimini ifade eden HTTP durum kodudur.
Ancak hata yalnızca tek cihazda görülüyor ve site diğer ağlarda çalışıyorsa özel proxy, VPN veya yerel ağ yapılandırmasını kontrol etmek mantıklıdır.
502 Hatasında DNS Değiştirmek Gerekir mi?
Ziyaretçi tarafında rastgele DNS değiştirmek her 502 hatasının çözümü değildir. Site sahibi açısından ise origin IP değişikliği veya hatalı DNS kaydı proxy/CDN’in yanlış sunucuya bağlanmasına neden olabileceği için DNS kayıtları kontrol edilmelidir.
502 Bad Gateway Hatası Devam Ediyorsa Ne Yapılmalı?
Site size aitse ve hata devam ediyorsa hosting sağlayıcısına yalnızca “502 alıyorum” demek yerine teşhisi hızlandıracak bilgileri gönderin:
- hata veren URL,
- hata kodu ve mesajı,
- hatanın oluştuğu tarih ve saat,
- saat dilimi,
- hatanın sürekli mi aralıklı mı olduğu,
- CDN/Cloudflare kullanılıp kullanılmadığı,
- sunucu veya uygulama loglarından ilgili kayıtlar.
Cloudflare da 5xx hatalarının araştırılmasında URL, hata kodu ve zaman bilgisinin hosting sağlayıcısıyla paylaşılmasını öneriyor.
Diğer HTTP Hata Kodları
502 hatasını benzer hata kodlarıyla karıştırıyorsanız şu rehberler de yardımcı olabilir:
502 Bad Gateway Hakkında Sık Sorulan Sorular
502 Bad Gateway ne demek?
Gateway veya proxy görevi yapan sunucunun isteği tamamlamak için eriştiği upstream sunucudan geçerli bir yanıt alamadığı anlamına gelir.
502 Bad Gateway hatası neden olur?
Upstream servisin çalışmaması, sunucu yükü, reverse proxy yapılandırması, PHP-FPM veya uygulama hataları, firewall, ağ, DNS veya CDN-origin iletişim problemleri 502’ye neden olabilir.
502 Bad Gateway benim internetimden kaynaklanır mı?
Çoğu 502 hatası sunucu tarafındadır. Ancak hizmet diğer kullanıcılar için çalışırken yalnızca sizin bağlantınızda hata oluşuyorsa VPN, proxy veya özel ağ yapılandırmanız kontrol edilebilir.
502 Bad Gateway nasıl düzeltilir?
Ziyaretçiyseniz kısa süre sonra tekrar deneyin. Site sahibiyseniz reverse proxy ve upstream servis loglarını, backend servisini, sunucu kaynaklarını, firewall, DNS ve CDN yapılandırmasını kontrol edin.
502 Bad Gateway Nginx ne demek?
Nginx’in proxy veya gateway olarak çalışırken arka taraftaki uygulama, PHP-FPM ya da başka bir upstream sunucudan geçerli yanıt alamadığını gösterir.
Cloudflare 502 hatası neden olur?
Cloudflare 502 hatası origin sunucudan veya bazı durumlarda Cloudflare altyapısından kaynaklanabilir. Cloudflare’a göre en yaygın senaryolardan biri origin sunucunun 502 veya 504 üretmesidir.
502 ile 504 arasındaki fark nedir?
502, gateway’in upstream’den geçerli yanıt alamadığını; 504 ise gerekli upstream yanıtının zamanında gelmediğini ifade eder.
502 hatası SEO’yu etkiler mi?
Kısa süreli tek bir 502 doğrudan SEO cezası değildir. Ancak uzun süre veya çok sayıda URL’de devam eden 5xx hataları Googlebot’un tarama hızını azaltabilir ve sürekli hata veren URL’ler zamanla dizinden çıkarılabilir.
Kaynaklar
