WordPress 502 Bad Gateway hatası nasıl çözülür?

Kısa yanıt

WordPress 502 Bad Gateway hatası, sitenizin önündeki bir ağ geçidi katmanının (Nginx, bir CDN veya ters proxy) arka uçtaki PHP sunucusundan geçerli bir yanıt alamadığı anlamına gelir. WordPress’in kendi kodu çoğu zaman sorunsuzdur; sorun istek WordPress’e ulaşmadan önceki iletişim ve zaman aşımı katmanındadır.

En sık nedenleri sunucunun anlık trafik artışıyla aşırı yüklenmesi, PHP-FPM’in bir isteğe zamanında yanıt verememesi, kötü kodlanmış bir eklenti veya tema, ve önündeki bir CDN’in yanlış yapılandırılmış proxy zaman aşımı ayarlarıdır. Aşağıdaki sıra en yaygın nedenden en nadirine doğru ilerler; her adımı denemeden bir öncekine geri dönmeyin, çünkü 502 hatası genellikle birden fazla küçük sorunun üst üste binmesiyle ortaya çıkar.

WordPress 502 Bad Gateway hatası neden çıkar?

Tarayıcıda görünen mesaj her zaman aynıdır (“502 Bad Gateway”), ama kaynağı birkaç farklı katmandan gelebilir:

• Sunucunun anlık bir trafik artışıyla veya bot taramasıyla aşırı yüklenmesi
• PHP-FPM’in tanımlı zaman aşımı süresi içinde yanıt verememesi (ağır bir sorgu, büyük bir dosya işlemi veya kilitlenmiş bir arka plan görevi yüzünden)
• Kötü kodlanmış bir eklenti veya temanın sunucu kaynaklarını (RAM, CPU) tüketmesi
• Önündeki bir CDN veya güvenlik duvarının (Cloudflare gibi) proxy zaman aşımı ayarının sunucunuzunkiyle uyuşmaması
• Sunucu tarafında geçici bir bakım, yeniden başlatma veya yapılandırma hatası

Ortak nokta, sorunun WordPress’in veritabanında veya içeriğinde değil, isteğin geçtiği ağ ve işlem katmanlarında olmasıdır. Bu da hatanın neden genellikle kendi kendine geçtiğini (sunucu yükü düştüğünde) ve neden bazen tekrar tekrar ortaya çıktığını açıklar.

502 hatası ile 500 Internal Server Error arasındaki fark

Bu iki hata sık karıştırılır, ama farklı katmanlardan gelir. 500 Internal Server Error, PHP kodunun kendisinde (bozuk bir eklenti, uyumsuz bir tema veya çekirdek dosyasında) oluşan bir hatayı gösterir; sunucu isteği alır, işler, ama işlem sırasında çöker. 502 Bad Gateway ise PHP’ye hiç ulaşılamadığını veya PHP’nin zaman aşımına uğradığını gösterir; ağ geçidi (Nginx veya CDN), arka uçtan hiçbir geçerli yanıt alamaz.

Bu ayrım pratikte önemlidir, çünkü 500 hatasında çözüm genellikle eklenti/tema hata ayıklamaya (WP_DEBUG açmak gibi) odaklanır; 502 hatasında ise sunucu kaynakları, zaman aşımı ayarları ve ağ katmanına bakmak gerekir. Eklenti hata ayıklama adımlarını WordPress kritik hata rehberimizde ayrıntılı olarak anlattık.

Önce basit kontrolleri yapın

Panik yapmadan önce birkaç hızlı testle hatanın geçici mi yoksa sürekli mi olduğunu belirleyin. Sayfayı yeniden yükleyin, tarayıcı önbelleğini temizleyin ve farklı bir tarayıcı veya cihazdan erişmeyi deneyin. Hata sadece sizde görünüyorsa sorun büyük olasılıkla yerel ağınız veya DNS önbelleğinizdedir; hata herkeste görünüyorsa sunucu veya ağ geçidi tarafında gerçek bir sorun vardır. Aynı anda WordPress önbellek eklentinizin önbelleğini de temizleyin, çünkü bozulmuş bir önbellek dosyası bazen aynı hatayı taklit edebilir.

CDN veya güvenlik duvarını geçici olarak devre dışı bırakın

Sitenizin önünde Cloudflare veya benzer bir CDN/güvenlik duvarı varsa, bu katman kendi proxy zaman aşımı veya önbellek kuralıyla hatayı tetikliyor olabilir. CDN panelinizden geçici olarak “geliştirici modu”na geçin veya DNS’i doğrudan sunucunuza yönlendirip siteye CDN’siz erişmeyi deneyin. Hata CDN’siz ortamda kaybolursa, sorun CDN’in proxy zaman aşımı ayarındadır; bu değeri sunucunuzun kendi zaman aşımı değeriyle (genellikle 60-120 saniye) eşleştirmeniz gerekir.

Eklentileri ve temayı tek tek devre dışı bırakın

CDN kontrolü sonuç vermediyse, sıradaki adım eklenti ve tema çakışmasıdır. Yönetim paneline erişebiliyorsanız tüm eklentileri tek seferde devre dışı bırakıp hatanın kaybolup kaybolmadığına bakın; kayboluyorsa eklentileri birer birer yeniden etkinleştirerek sorumlu olanı bulun. Panele giriş yapamıyorsanız aynı işlemi FTP üzerinden wp-content/plugins klasöründeki eklenti klasörlerini tek tek geçici olarak yeniden adlandırarak yapabilirsiniz. Özellikle ağır veritabanı sorguları çalıştıran yedekleme, arama veya analitik eklentileri bu hatanın yaygın tetikleyicilerindendir.

Tema da aynı şekilde test edilmelidir. Geçici olarak WordPress’in varsayılan bir temasına (Twenty Twenty-Four gibi) geçip hatanın devam edip etmediğine bakın; kaybolursa sorumlu, mevcut temanızdaki ağır bir fonksiyon veya sorgu çağrısıdır.

PHP-FPM zaman aşımı ve kaynak limitlerini kontrol edin

Eklenti ve tema temiz çıktıysa, sorun sunucunun PHP-FPM yapılandırmasında olabilir. PHP-FPM, tanımlı bir süre içinde (request_terminate_timeout) yanıt alamadığı istekleri sonlandırır ve bu da Nginx’in 502 döndürmesine yol açar. Hosting panelinizde veya sunucu yapılandırma dosyalarında bu zaman aşımı değerini ve PHP’nin bellek limitini (memory_limit) kontrol edin; bellek yetersizliği bazen 502 olarak, bazen de 500 olarak görünebilir, bu yüzden ikisini birlikte değerlendirmek gerekir. Bellek limiti sorununu ayrıntılı çözmek için allowed memory size hatası rehberimize bakabilirsiniz.

Paylaşımlı hosting kullanıyorsanız, bu limitleri kendi panelinizden değiştiremeyebilirsiniz; bu durumda hosting sağlayıcınızdan PHP-FPM havuzunuzun (pool) zaman aşımı ve işlem sayısı ayarlarını artırmasını istemeniz gerekir.

Sunucu aşırı yüklenmesi ve trafik artışı

Sunucu kaynakları (CPU, RAM, eşzamanlı işlem sayısı) anlık bir trafik artışıyla (bir kampanya, bir bot taraması veya bir DDoS girişimi) tükendiğinde, PHP-FPM yeni istekleri işleyecek kapasite bulamaz ve 502 hatası ortaya çıkar. Hosting panelinizin kaynak kullanım grafiklerine bakarak hatanın oluştuğu saatte bir yük artışı olup olmadığını kontrol edin. Düzenli olarak tekrarlanıyorsa, mevcut hosting planınızın site trafiğiniz için yetersiz kaldığı anlamına gelebilir ve bir kaynak yükseltmesi gerekebilir.

Hata günlüklerine bakın

Hosting sağlayıcınızın sunduğu hata günlüklerine (error log) veya sunucu panelindeki PHP/Nginx günlüklerine erişiminiz varsa, hatanın tam oluştuğu saniyeyi ve hangi istekle tetiklendiğini burada görebilirsiniz. Bu günlükler genellikle hangi PHP betiğinin zaman aşımına uğradığını veya hangi bellek hatasının oluştuğunu doğrudan gösterir, bu da yukarıdaki adımları tahmin yürütmeden doğrulamanızı sağlar.

Hiçbir adım işe yaramazsa ne yapmalı?

Yukarıdaki adımların tamamını denediyseniz ve WordPress 502 Bad Gateway hatası hâlâ sürüyorsa, sorun büyük olasılıkla sunucu altyapısında, sizin panelden tam olarak göremeyeceğiniz bir katmandadır: paylaşımlı sunucudaki diğer sitelerin kaynak tüketimi, PHP-FPM havuz yapılandırması veya ağ geçidi düzeyinde bir donanım sorunu gibi. Bu noktada en hızlı yol, hatanın tam saatini, sıklığını ve hangi sayfalarda çıktığını hosting destek ekibiyle paylaşmaktır; sunucu günlüklerine erişimleri, sizin göremeyeceğiniz kesin nedeni ortaya çıkarabilir.

WordPress 502 Bad Gateway hatasını tekrar yaşamamak için

Bu hatanın büyük kısmı önlenebilir. Trafik artışı beklenen kampanya dönemlerinde hosting kaynaklarınızı önceden gözden geçirin; eklenti ve tema güncellemelerini canlı siteye geçmeden önce bir test ortamında deneyin; CDN’inizin proxy zaman aşımı ayarını sunucunuzunkiyle eşleştirin. Bu konuyu daha genel bir çerçevede ele alan WordPress 500 Internal Server Error rehberimizde de görüldüğü gibi, çoğu WordPress sunucu hatası aynı üç kaynaktan (kaynak yetersizliği, zaman aşımı, yapılandırma) besleniyor.

WordPress’in kendi Site Health aracının sunucu bağlantı sorunlarını nasıl tespit ettiğini görmek isterseniz, WordPress’in resmî class-wp-site-health.php kaynak kodunda yer alan get_test_loopback_requests() fonksiyonunu inceleyebilirsiniz; bu fonksiyon, sitenizin kendi sunucusuna geri istek gönderip gönderemediğini (loopback) test eder ve bu test başarısız olduğunda zamanlanmış görevlerin (WP-Cron) ve eklenti/tema düzenleyicisinin neden çalışmadığını gösterir, tam olarak 502 benzeri bağlantı sorunlarının WordPress tarafından nasıl algılandığının bir örneğidir.

Sonraki adım

WordPress 502 Bad Gateway hatası ürkütücü görünse de çoğu zaman sunucu kaynaklarını veya zaman aşımı ayarlarını düzeltmekle çözülen, veri kaybı riski taşımayan bir bağlantı sorunudur. Sorun sunucu tarafında tekrarlıyorsa veya hosting altyapınızı performans açısından birlikte gözden geçirmek istiyorsanız, grup şirketimiz Web Tasarım Ofisi WordPress bakımı ve sunucu performansı konusunda destek veriyor.

Sitenizin teknik altyapısını veya özel yazılım ihtiyaçlarınızı birlikte değerlendirmek için özel yazılım hizmetimizi inceleyebilir ya da bizimle iletişime geçebilirsiniz.