TR EN

Nginx 502 Bad Gateway Hatası Çözümü (PHP-FPM & Upstream)

502 yanıtında yapılandırmayı değiştirmeden veya servisleri yeniden başlatmadan önce sorunlu istek yolunu ve upstream servisi belirleyin.

Önce yanıtı ve istek yolunu belirleyin

502, ağ geçidi veya proxy'nin upstream yanıtında sorunla karşılaştığını gösterir; durum kodu tek başına arızalı servisi belirlemez. Etkilenen URL yolunu, zamanı, varsa istek kimliğini, hatanın aralıklı olup olmadığını ve yanıtı veren proxy veya CDN katmanını not edin. Sorgu dizelerini, çerezleri, tokenları veya istek gövdelerini paylaşmayın.

1. Nginx hata kaydıyla eşleştirin

O zamana ait yapılandırılmış Nginx hata kaydını inceleyin. Yolu ortama göre değişir; aşağıdaki komut yalnız yerel bir örnektir:

sudo tail -n 50 /var/log/nginx/error.log

connect() failed ve bağlantı reddi, belirtilen upstream adresi veya dinleyiciyi incelemeyi gerektirir; Unix soketinde no such file yol ve dosyanın varlığını; permission denied soket erişimini ve zorunlu erişim kontrollerini; upstream prematurely closed connection uygulama kayıtlarıyla eşleştirmeyi gerektirir. Bunlar ipucudur, kesin neden değildir. Günlükler hassas veri içerebilir; paylaşmadan önce maskeleyin.

2. Gerçek upstream'i belirleyin

İlgili sanal sunucu ve location bloğundaki proxy_pass veya fastcgi_pass hedefini bulun. Nginx sunucusunda sudo nginx -t yapılandırmayı ve ilgili dosyaları sınar; sudo nginx -T bunlara ek olarak yapılandırmayı yazdırır. İkincisi iç sunucu adları ve sırları açığa çıkarabilir: yalnız yerelde inceleyin, çıktısını paylaşmayın. Kaynak: Nginx komutları. Gerçek soket/adresi servis dinleyicisiyle karşılaştırın; konteyner ağ alanını ve servis adlarını hesaba katın.

3. İlgili servisi inceleyin

Dağıtımınızdaki gerçek servis adı ve sürümüyle durumu ve kayıtları inceleyin. PHP-FPM kullanıyorsanız pool listen değerini Nginx fastcgi_pass ile; Unix soket sahibini, grubunu ve izinlerini karşılaştırın. PHP-FPM yapılandırması dinleyici ve süreç sınırlarını açıklar. FastCGI uç noktasını internete açmayın. Node veya Python kullanıyorsanız PHP-FPM varsaymak yerine ilgili uygulamanın dinleyicisini ve kayıtlarını inceleyin.

4. Yalnız doğrulanan değişikliği yapın

Havuz yoğunluğunda süreç sayısını değiştirmeden önce kuyruk, limit ve bellek kanıtını birlikte inceleyin; kapasite olmadan süreç artırmak sorunu büyütebilir. Servisi rastgele yeniden başlatmayın, sabit PHP soket yolunu kopyalamayın, erişim kontrollerini kapatmayın veya zaman aşımını otomatik artırmayın. Yapılandırma değişikliği gerekiyorsa geri dönüş hazırlayın, ilgili sözdizimini sınayın ve yayın prosedürünüzü izleyin.

Aynı yolda güvenli ve yetkili bir istekle tekrar deneyip proxy ve uygulama sonuçlarını karşılaştırın. Durum değiştiren istekleri veya gerçek kullanıcı verisini tekrar göndermeyin. 502 kaynağımız özel upstream'i incelemez ve nedeni kanıtlamaz.

CDN varsa

CDN markalı bir 502 tek başına hatanın hangi bileşenden kaynaklandığını göstermez. Sağlayıcının yanıt ayrıntılarını origin kayıtlarıyla eşleştirin: Cloudflare 502/504 rehberi. Gözden geçirme: 15 Kasım 2026.

Sıkça Sorulan Sorular

502 Bad Gateway sunucu hatası mıdır, istemci hatası mıdır?
502 bir ağ geçidinin upstream iletişim sorununu gösteren yanıttır. Tek başına nedeni, arızalı servisi veya isteğin tüm yönleriyle geçerli olduğunu kanıtlamaz.
Cloudflare kullanırken 502 hatası ne anlama gelir?
502 yanıtını Cloudflare veya origin üretebilir. Belirli bir nedeni varsaymak yerine sağlayıcı yanıtını ve origin kayıtlarını karşılaştırın.