Ö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.logconnect() 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.