502 Bad Gateway Hatası Nedir? Nedenleri ve Çözüm Yöntemleri

502 Bad Gateway, bir sunucunun ağ geçidi veya ters vekil olarak davranırken arka uç sunucudan geçersiz yanıt aldığını bildiren HTTP durum kodudur. Ziyaretçinin tarayıcısı ile web sitesi arasında iki sunucu bulunur: isteği karşılayan ön uç sunucu ve içeriği üreten arka uç sunucu. Ön uç sunucu arka uçtan anlamlandıramadığı bir yanıt aldığında bağlantıyı keser ve 502 kodunu döndürür. Hata ziyaretçinin cihazında değil, sunucu tarafında oluşur.

Bu rehberde 502 Bad Gateway hatasının Türkçe karşılığını, HTTP 5xx kodları arasındaki yerini ve oluşma nedenlerini açıklıyoruz. Ardından hatanın kaynağını sunucu günlüklerinden bulmayı, Nginx, Apache ve LiteSpeed tarafındaki çözümleri, WordPress sitelerine özgü adımları, Cloudflare kaynaklı 502 ayrımını ve cPanel, Plesk, CWP panellerindeki müdahaleyi anlatıyoruz. Son bölümlerde hatanın kalıcı olarak nasıl önleneceğini, barındırma türünün hata sıklığına etkisini ve 502 kodunun arama motoru performansına yansımasını ele alıyoruz.

502 Bad Gateway Hatası Ne Demek?

502 Bad Gateway, ağ geçidi görevi gören sunucunun arka uç sunucudan geçersiz bir yanıt aldığını bildiren HTTP durum kodudur. Kodun Türkçe karşılığı “hatalı ağ geçidi” biçimindedir. Sunucu isteği almıştır ve iletmiştir, ancak dönen yanıt HTTP kurallarına uymadığı için işlenemez. 502 kodu sunucu hata sınıfına aittir ve sorumluluk barındırma altyapısındadır.

502 hatası tarayıcıda “502 Bad Gateway”, “HTTP Error 502”, “502 Server Error” veya “Bad Gateway nginx” gibi farklı metinlerle görüntülenir. Metnin biçimi hatayı üreten sunucu yazılımına göre değişir ve bu ayrım sorunun kaynağını daraltmakta kullanılır.

502 Hatası HTTP 5xx Kodları Arasında Nerede Durur?

HTTP 5xx sınıfındaki kodlar sunucu kaynaklı hataları tanımlar. Kodların anlamları ve sorumlu katmanları aşağıdaki tabloda karşılaştırılmıştır.

502 ile 504 kodları aynı katmanda oluşur ve sıklıkla karıştırılır. Aradaki fark yanıtın niteliğindedir: 502 kodunda arka uçtan geçersiz bir yanıt gelir, 504 kodunda ise hiçbir yanıt gelmez. 503 hatası ise bağlantı kurulmadan önce sunucunun isteği reddetmesiyle oluşur ve 503 Service Unavailable hatası ayrı bir çözüm yolu gerektirir.

502 Bad Gateway Hatası Neden Oluşur?

502 Bad Gateway hatasının başlıca nedenleri aşağıda listelenmiştir:

• Arka uç sunucunun çökmesi veya yeniden başlatılması
• PHP-FPM süreç havuzunun dolması
• Zaman aşımı sürelerinin yetersiz kalması
• Güvenlik duvarının vekil bağlantısını kesmesi
• Sunucu belleğinin tükenmesi
• Yanlış yapılandırılmış vekil hedefi
• Soket dosyasının bulunamaması
• Ağ katmanındaki paket kaybı

Arka Uç Sunucunun Yanıt Vermemesi

Arka uç sunucu servisi durduğunda ters vekil bağlantı kuramaz ve 502 kodunu döndürür. PHP-FPM, Node.js veya Python uygulama sunucusu bu görevi üstlenir. Servis durumu systemctl status php-fpm komutuyla doğrulanır. Servis durmuşsa hata sunucu günlüğünde connect() failed (111: Connection refused) satırıyla görünür.

PHP-FPM Süreç Havuzunun Dolması

PHP-FPM havuzundaki eşzamanlı süreç sayısı pm.max_children değerine ulaştığında yeni istekler kuyruğa alınır. Kuyruk da dolduğunda bağlantı reddedilir ve 502 kodu üretilir. Varsayılan değer çoğu kurulumda 5 ile 10 arasındadır ve orta ölçekli bir site için yetersiz kalır. Günlükte server reached pm.max_children setting uyarısı görülür. Bellek başına ortalama PHP süreç tüketimi 60 MB kabul edilerek doğru değer hesaplanır. Sürüm ve uzantı yönetimi konusunda PHP hosting altyapısı belirleyicidir.

Zaman Aşımı Sürelerinin Yetersizliği

Ters vekil, arka uçtan yanıt beklerken belirli bir süre sınırı uygular. Nginx tarafında proxy_read_timeout varsayılan değeri 60 saniyedir, fastcgi_read_timeout değeri de aynı sürededir. Uzun süren bir işlem bu sınırı aştığında bağlantı kesilir ve yanıt eksik kaldığı için 502 kodu döner.

Güvenlik Duvarı ve Bot Korumasının Bağlantıyı Kesmesi

Sunucu üzerindeki güvenlik duvarı kuralları, ters vekil ile arka uç arasındaki yerel bağlantıyı da denetler. ModSecurity kuralı veya bot koruma modülü isteği ortada kestiğinde ön uç sunucu geçersiz yanıt alır. Kural kimliği güvenlik günlüğünde yer alır ve istisna tanımlanarak bağlantı serbest bırakılır. Kural yapısı hakkında ayrıntı için güvenlik duvarı yapılandırması incelenir.

Sunucu Kaynaklarının Tükenmesi

Bellek tükendiğinde Linux çekirdeği en çok bellek tüketen süreci sonlandırır. Sonlandırılan süreç PHP-FPM veya veritabanı sunucusu olduğunda arka uç yanıt veremez ve 502 kodu üretilir. Olay dmesg çıktısında Out of memory: Killed process satırıyla kayıt altına alınır. Paylaşımlı barındırmada komşu hesapların tükettiği bellek de bu duruma yol açar.

502 Hatasının Kaynağı Loglardan Nasıl Bulunur?

502 hatasının nedeni sunucu hata günlüğündeki tek bir satırda yazılıdır. Kaynağı bulmak için aşağıdaki adımlar sırayla uygulanır:

1. Hata günlüğünü aç: tail -n 100 /var/log/nginx/error.log
2. Hatanın oluştuğu saat aralığını belirle ve o aralıktaki [error] satırlarını süz
3. Satırdaki upstream ifadesinden sonraki bölümü oku, arka uç adresi burada yazılıdır
4. Parantez içindeki sistem hata numarasını not al, neden bu numarada saklıdır
5. PHP-FPM günlüğünü karşılaştır: tail -n 100 /var/log/php-fpm/error.log

Sık karşılaşılan üç günlük satırı ve anlamları aşağıda verilmiştir.

connect() failed (111: Connection refused) while connecting to upstream

Arka uç servisi çalışmıyor. PHP-FPM veya uygulama sunucusu yeniden başlatılır.

upstream prematurely closed connection while reading response header

Arka uç yanıtı tamamlamadan bağlantıyı kapattı. Bellek limiti veya süreç sonlandırması söz konusudur.

upstream sent too big header while reading response header

Yanıt başlığı tampon boyutunu aştı. proxy_buffer_size değeri artırılır.

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

Nginx tarafındaki 502 hatası, vekil hedefinin doğrulanması ve tampon ile zaman aşımı değerlerinin düzeltilmesiyle çözülür. Çözüm adımları aşağıda sıralanmıştır:

1. Yapılandırmayı sınayın: nginx -t
2. proxy_pass satırındaki adresin ve bağlantı noktasının arka uçla eşleştiğini doğrulayın
3. Soket kullanılıyorsa soket dosyasının varlığını kontrol edin: ls -l /run/php/php8.2-fpm.sock
4. Soket izinlerinin Nginx kullanıcısıyla uyumlu olduğunu doğrulayın
5. Zaman aşımı ve tampon değerlerini artırın
6. Yapılandırmayı yeniden yükleyin: systemctl reload nginx

Zaman aşımı ve tampon ayarları için kullanılan yapılandırma bloğu aşağıdadır:

proxy_connect_timeout 60s;
proxy_send_timeout 180s;
proxy_read_timeout 180s;
proxy_buffer_size 16k;
proxy_buffers 8 16k;

Sunucu yazılımının çalışma mantığı ve modül yapısı hakkında ayrıntılı bilgi Nginx rehberinde yer alır.

Nginx Ters Vekil Yapılandırması Nasıl Kontrol Edilir?

Ters vekil yapılandırması location bloğu içindeki proxy_pass satırıyla tanımlanır. Doğru biçim, hedef adresin sonunda eğik çizgi bulunup bulunmamasına göre farklı davranır. Aşağıdaki blok tipik bir ters vekil tanımıdır:

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

Hedef bağlantı noktasında bir servisin dinlediği ss -tlnp | grep 3000 komutuyla doğrulanır. Çıktı boşsa arka uç çalışmıyor demektir.

Apache ve LiteSpeed Sunucularda 502 Hatası Nasıl Giderilir?

Apache sunucularda 502 hatası mod_proxy modülü üzerinden oluşur, LiteSpeed sunucularda ise lsphp süreç yöneticisi kaynaklıdır. İki sunucunun müdahale noktaları aşağıdaki tabloda karşılaştırılmıştır.

LiteSpeed sunucularda süreç sayısı Max Connections değeriyle sınırlanır ve bu değer aşıldığında 502 kodu üretilir. LiteSpeed hosting paketlerinde bu değer paket düzeyine göre tanımlanır.

WordPress Sitelerinde 502 Bad Gateway Hatası Nasıl Düzeltilir?

WordPress sitelerindeki 502 hatası çoğunlukla bir eklentinin arka uç sürecini kilitlemesinden kaynaklanır. Düzeltme adımları aşağıda sıralanmıştır:

1. FTP veya dosya yöneticisi üzerinden wp-content/plugins klasörünün adını plugins-devre-disi olarak değiştirin. Site açılıyorsa hata bir eklentiden kaynaklanıyordur.
2. Klasör adını geri alın ve eklentileri tek tek etkinleştirerek sorunlu olanı belirleyin.
3. Temayı varsayılan temayla değiştirin ve sonucu gözlemleyin.
4. wp-config.php dosyasına bellek sınırını ekleyin: define('WP_MEMORY_LIMIT', '256M');
5. Önbellek eklentisinin ürettiği dosyaları temizleyin ve eklentiyi yeniden yapılandırın.
6. .htaccess dosyasını yeniden adlandırın, ardından Ayarlar bölümünden kalıcı bağlantıları yeniden kaydedin.

Her adımdan sonra site yenilenir ve hatanın devam edip etmediği kontrol edilir. Önbellek katmanı ve sunucu yanıt süresi ilişkisi WordPress hızlandırma rehberinde ayrıntılandırılmıştır.

Cloudflare Kullanan Sitelerde 502 Hatası Ne Anlama Gelir?

Cloudflare kullanan sitelerde 502 hatası iki farklı kaynaktan gelir ve hata sayfasının görünümü kaynağı belli eder. Cloudflare markası, Ray ID numarası ve “Error 502” ibaresi taşıyan sayfa Cloudflare’in kendi ağından gelir. Sade bir “502 Bad Gateway” metni ise doğrudan barındırma sunucusundan döner.

Kaynağı kesinleştirmek için iki test uygulanır. Birinci testte Cloudflare panelinde geliştirici modu etkinleştirilir ve önbellek devre dışı bırakılır. İkinci testte alan adının DNS kaydı gri buluta alınarak trafik doğrudan sunucuya yönlendirilir. Gri bulut modunda hata devam ediyorsa sorun sunucudadır. Ağın çalışma mantığı ve mod ayarları için Cloudflare rehberi incelenir.

cPanel, Plesk ve CWP Panellerinde 502 Hatası Nasıl Çözülür?

Kontrol paneli kullanılan sunucularda 502 hatası panel arayüzünden çözülür. Üç panelde izlenecek yollar aşağıda listelenmiştir:

• cPanel: WHM üzerinden Restart Services bölümüne girilir, PHP-FPM ve HTTP Server servisleri yeniden başlatılır. Hata günlüğü Metrics bölümündeki Errors sayfasında görüntülenir.
• Plesk: Tools and Settings bölümündeki Services Management sayfasından PHP-FPM ve web sunucusu yeniden başlatılır. Alan adı bazında PHP işleyicisi Hosting Settings sayfasından değiştirilir.
• CWP: Service Config bölümünden cwpsrv servisi yeniden başlatılır. Panel arayüzünde 502 hatası görülmesi çoğunlukla bu servisin durmasından kaynaklanır ve systemctl restart cwpsrv komutu sorunu giderir.

Panel üzerinden yapılan müdahalede servis yeniden başlatma işlemi kısa bir kesinti oluşturur. Panel özellikleri ve servis yönetimi hakkında ayrıntı cPanel hosting rehberindedir.

502 Bad Gateway Hatası Kalıcı Olarak Nasıl Önlenir?

502 Bad Gateway hatasının tekrarını önleyen önlemler aşağıda sıralanmıştır:

1. Kaynak kullanımını izleyin. Bellek ve CPU kullanımı izlenmediğinde tükenme anı fark edilmez ve hata rastgele tekrar eder.
2. Süreç havuzunu ölçekleyin. pm.max_children değeri trafiğe göre hesaplanmadığında yoğun saatlerde havuz dolar.
3. Zaman aşımı sürelerini işleme göre ayarlayın. Uzun süren toplu işlemler için ayrı bir vekil bloğu tanımlanmadığında her toplu işlem 502 üretir.
4. Önbellek katmanı kurun. Önbelleksiz sistemde her istek arka uca ulaşır ve havuz gereksiz yere dolar.
5. İzleme ve uyarı sistemi kurun. Uyarı kurulmadığında hata ziyaretçi bildirimiyle öğrenilir ve kesinti süresi uzar.
6. Barındırma paketini yükseltin. Kaynak sınırı sürekli aşılıyorsa ayar değişikliği çözüm üretmez.

Barındırma Türü 502 Hatası Sıklığını Nasıl Etkiler?

Barındırma türü, 502 hatasının hem sıklığını hem de müdahale yetkisini belirler. Üç barındırma türünün karşılaştırması aşağıdaki tabloda verilmiştir.

Paylaşımlı barındırmada süreç havuzu tüm hesaplar arasında paylaşılır ve komşu bir hesabın ürettiği yük 502 hatasına yol açar. Sanal sunucuda kaynaklar hesaba tahsis edilir, süreç ve zaman aşımı değerleri doğrudan değiştirilir. Verimin olarak sunduğumuz sunucularda %99,9 çalışma süresi taahhüdü veriyoruz ve İstanbul lokasyonlu altyapımızla Türkiye hedefli projelerde gecikmeyi en aza indiriyoruz. Kaynak tahsisi ve yönetim yetkisi ihtiyacı doğduğunda sanal sunucu paketlerine geçiş yapılır.

502 Hatası SEO Performansını Nasıl Etkiler?

502 hatası kısa sürelerde sıralamayı etkilemez, uzun sürelerde ise sayfanın indeksten düşmesine yol açar. Googlebot bir sayfada 5xx kodu aldığında taramayı erteler ve kısa süre sonra yeniden dener. Hata birkaç saat içinde giderildiğinde sıralamada kalıcı bir kayıp oluşmaz.

Hata birkaç gün sürdüğünde Googlebot tarama hızını düşürür ve etkilenen sayfaları arama sonuçlarından geçici olarak çıkarır. Google Search Console üzerindeki Sayfalar raporunda bu durum “Sunucu hatası (5xx)” başlığıyla raporlanır ve etkilenen adres sayısı listelenir. Tarama bütçesi düşen bir sitede yeni yayınlanan içeriklerin dizine girme süresi de uzar. Sunucu yanıt süresinin sayfa deneyimi metriklerine yansıması Core Web Vitals rehberinde ele alınmıştır.

502 Bad Gateway Hatası Tarayıcı Kaynaklı Olur mu?

Hayır, 502 Bad Gateway hatası tarayıcıdan kaynaklanmaz. Hata sunucu tarafında üretilir ve tarayıcı yalnızca sunucudan gelen kodu görüntüler. Tek istisna, kurumsal ağlardaki vekil sunucuların bağlantıyı kesmesidir; bu durumda aynı site farklı bir ağdan sorunsuz açılır.

502 Hatası Veri Kaybına Yol Açar mı?

Hayır, 502 hatası kayıtlı verilere zarar vermez. Hata istek işlenirken oluşur ve veritabanındaki mevcut kayıtlar etkilenmez. İstisna, form gönderimi sırasında hatanın oluşmasıdır; bu durumda gönderilen veri sunucuya ulaşmadığı için kaydedilmez ve işlem tekrarlanır.

502 Bad Gateway Hatası Kendiliğinden Düzelir mi?

Evet, anlık yük artışından kaynaklanan 502 hatası birkaç dakika içinde kendiliğinden düzelir. Yapılandırma hatası, durmuş servis veya yetersiz kaynak kaynaklı 502 hatası ise müdahale edilmeden düzelmez ve düzenli aralıklarla tekrar eder.

502 Hatası Alan Adı veya DNS Kaynaklı mıdır?

Hayır, 502 hatası alan adı veya DNS yapılandırmasından kaynaklanmaz. 502 kodunun görüntülenmesi, alan adının doğru sunucuya çözümlendiğini ve bağlantının kurulduğunu kanıtlar. DNS kaynaklı sorunlar bağlantı kurulmadan önce oluşur ve tarayıcıda farklı bir hata mesajıyla görüntülenir. Ad çözümleme süreci DNS nedir rehberinde anlatılmıştır.

Sunucumda 502 Hatası Sürekli Tekrar Ediyorsa Ne Yapmalıyım?

Tekrar eden 502 hatası kaynak yetersizliğine veya kalıcı bir yapılandırma sorununa işaret eder ve teknik inceleme gerektirir. Destek talebi açarken aşağıdaki dört bilgiyi iletmeniz inceleme süresini kısaltır:

• Hatanın görüldüğü alan adı ve tam adres
• Hatanın oluştuğu tarih ve saat aralığı
• Sunucu hata günlüğündeki ilgili satır
• Tarayıcıda görünen hata sayfasının ekran görüntüsü

Verimin müşterisi olarak sunucunuzda tekrar eden 502 hatası için teknik destek ekibimize başvurabilirsiniz. Günlük kayıtlarını inceliyor, süreç havuzu ve zaman aşımı değerlerini projenizin yüküne göre yeniden yapılandırıyoruz.