Blog’a Dön

502 Bad Gateway Hatası: Sebepleri ve Çözümü

502 Bad Gateway hatası mı alıyorsunuz? Nginx hata günlüğünü okuma, PHP-FPM ya da uygulamayı başlatma, port ve soket, pm.max_children, Cloudflare kontrolü.

Nodesty Ekibi8 dk okumaHosting
Koyu Nodesty arka planında 502 Bad Gateway yazısı ile nginx, upstream ve PHP-FPM ifadeleri

502 Bad Gateway hatası, sitenizin önünde duran bir sunucunun, genellikle Nginx'in, bir CDN'in ya da yük dengeleyicinin, isteği arkasındaki uygulamaya iletip kullanılabilir bir yanıt alamadığı anlamına gelir. Proxy çalışıyordur; sorun neredeyse her zaman upstream tarafındadır: PHP-FPM, bir Node.js ya da Python uygulaması veya kapalı olan, başka bir adreste dinleyen ya da yük altında çöken bir Docker konteyneri.

Bu rehberde gerçek sebebi Nginx hata günlüğünden bulmayı ve en sık karşılaşılan durumları çözmeyi anlatıyoruz: duran servis, yanlış port ya da soket, dolan PHP-FPM havuzu, bellek sorunları, büyük başlıklar, SELinux, Cloudflare ve Docker. Tüm durum kodlarına genel bir bakış için HTTP hata kodları rehberimize göz atabilirsiniz.

İlk adım: Nginx hata günlüğünü okuyun

Tarayıcı yalnızca "502 Bad Gateway" gösterir, ama Nginx asıl sebebi hata günlüğüne yazar. Sunucunuza SSH ile bağlandıktan sonra son satırlara bakın:

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

Sitenin server bloğunda kendine ait bir error_log satırı varsa o dosyaya bakın. sudo tail -f /var/log/nginx/error.log çalışırken sayfayı tarayıcıda yenilerseniz yeni satırın düştüğünü görürsünüz. En sık karşılaşacağınız mesajlar şunlardır:

error.log'daki mesajGenellikle ne anlama gelir
connect() failed (111: Connection refused)O portta dinleyen yok: uygulama kapalı
connect() to unix:/run/php/php8.3-fpm.sock failed (2: ...)Soket yok: yol yanlış ya da FPM durmuş
connect() to unix:... failed (13: Permission denied)Nginx soketi açamıyor ya da SELinux engelliyor
upstream prematurely closed connectionUygulama yanıt verirken çöktü ya da sonlandırıldı
upstream sent too big headerYanıt başlıkları Nginx'in tamponundan büyük
upstream timed out (110: Connection timed out)Uygulama fazla yavaş; Nginx bu durumda 504 döndürür

Her satırda ayrıca upstream: "..." bölümü bulunur; bu, Nginx'in ulaşmaya çalıştığı adrestir. Uygulamanızın gerçekte dinlediği adresle karşılaştırın.

Uygulama ya da PHP-FPM çalışmıyor

Açık ara en sık sebep budur. PHP siteleri için PHP-FPM servisini kontrol edin (8.3 yerine kendi sürümünüzü yazın):

systemctl status php8.3-fpm
sudo systemctl restart php8.3-fpm

AlmaLinux'ta servisin adı yalnızca php-fpm'dir. Node.js ya da Python uygulamasında kullandığınız süreç yöneticisine bakın:

pm2 status
pm2 logs --lines 50
sudo systemctl status myapp
sudo journalctl -u myapp -n 50

Servis başlamıyorsa sebebini kendi günlüğü gösterir: bir sözdizimi hatası, eksik bir ortam değişkeni ya da zaten kullanılan bir port (bkz. Port kullanımda hatası). Uygulamanın çöktükten ya da yeniden başlatmadan sonra kendiliğinden ayağa kalkması için onu systemd servisi oluşturma rehberindeki gibi bir servis olarak çalıştırın. Gunicorn arkasındaki bir Python uygulaması için çalışan bir kurulumu Python uygulamasını yayınlama rehberimizde bulabilirsiniz.

Yanlış upstream portu ya da soket yolu

Uygulama çalıştığı hâlde Nginx hâlâ Connection refused alıyorsa yanlış kapıyı çalıyordur. proxy_pass ya da fastcgi_pass satırındaki adresi gerçekte dinleyen adresle karşılaştırın:

sudo ss -tlnp | grep -E 'node|python|php|gunicorn'
ls -l /run/php/

Klasik örnek PHP sürüm yükseltmesidir: Yeni sürüm /run/php/php8.4-fpm.sock soketini oluşturur, ama site hâlâ artık var olmayan php8.3-fpm.sock soketini gösterir ve günlükte (2: No such file or directory) çıkar. fastcgi_pass satırını PHP sürümü değiştirme rehberinde gösterildiği gibi yeni sokete göre güncelleyin.

Sessiz bir tuzak da localhost'tur. proxy_pass http://localhost:3000; IPv6 adresi ::1'e çözülür ama uygulama yalnızca 127.0.0.1 üzerinde dinlerse bağlantı reddedilir. Adresi açıkça yazın:

location / {
    proxy_pass http://127.0.0.1:3000;
}

Sokette Permission denied

PHP-FPM soketinde (13: Permission denied) hatası, Nginx kullanıcısının soketi açamadığını gösterir. Ubuntu ve Debian'da Nginx www-data kullanıcısıyla çalışır ve /etc/php/8.3/fpm/pool.d/www.conf havuz dosyası buna uymalıdır:

listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

AlmaLinux'ta Nginx nginx kullanıcısıyla çalışır ve varsayılan havuz /run/php-fpm/www.sock üzerinde dinler; /etc/php-fpm.d/www.conf dosyasındaki listen.acl_users satırında nginx olduğundan emin olun. Her değişiklikten sonra PHP-FPM'i yeniden başlatın.

PHP-FPM'in işçileri tükendi: pm.max_children

502 hataları yalnızca yoğun saatlerde çıkıyorsa PHP-FPM günlüğüne bakın:

sudo grep max_children /var/log/php8.3-fpm.log

WARNING: [pool www] server reached pm.max_children setting (5), consider raising it gibi bir satır, tüm PHP işçilerinin meşgul olduğunu gösterir. Debian ve Ubuntu'daki varsayılan 5 değeri yoğun bir site için düşüktür. Bir işçinin ortalama ne kadar bellek kullandığını bulun:

ps --no-headers -o rss -C php-fpm8.3 | awk '{s+=$1} END {print s/NR/1024 " MB"}'

PHP'ye ayırabileceğiniz RAM'i bu sayıya bölün. PHP için 4 GB ayırıyorsanız ve işçiler 80 MB civarındaysa 50 civarı makul bir sınırdır. Değeri havuz dosyasına yazıp PHP-FPM'i yeniden başlatın:

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15

Değeri RAM'inizin kaldıracağından yükseğe çekmeyin: Fazla işçi sunucuyu swap'a ya da bellek yetersizliğine iter ve bu da doğrudan bir sonraki sebebe yol açar.

Bellek bitince uygulama sonlandırılıyor

Sunucunun RAM'i bittiğinde çekirdeğin OOM killer'ı en çok bellek kullanan süreci, çoğu zaman PHP-FPM işçilerini, Node.js'i ya da veritabanını sonlandırır. Nginx de kapanan bir bağlantı ya da reddedilen bir port görür. Bunun olup olmadığını kontrol edin:

sudo dmesg -T | grep -i -E 'out of memory|killed process'
free -h

Eşleşme bulursanız bellek kullanımını azaltın (daha az işçi, daha düşük sınırlar), Linux swap oluşturma rehberindeki gibi tampon olarak swap ekleyin ya da daha fazla RAM'i olan bir pakete geçin. Kaynakları neyin tükettiğini bulmak için Sunucu yavaşladı rehberimize bakabilirsiniz.

upstream sent too big header

Büyük çerezler ya da çok sayıda başlık gönderen uygulamalar (bazı WordPress eklentileri, kimlik doğrulama proxy'leri) Nginx'in varsayılan tamponunu aşabilir. proxy_pass ya da PHP-FPM kullanmanıza göre location bloğunda tamponu büyütün:

# Reverse proxy (proxy_pass)
proxy_buffer_size 16k;
proxy_buffers 8 16k;

# PHP-FPM (fastcgi_pass)
fastcgi_buffer_size 32k;
fastcgi_buffers 16 16k;

Zaman aşımları: 502 mi, 504 mü?

Uygulama fazla yavaşsa Nginx, proxy_read_timeout süresi (varsayılan 60 saniye) dolunca 504 Gateway Timeout döndürür. Dışa aktarma gibi uzun işlemler için bu süreyi tek bir location'da proxy_read_timeout 300s; (PHP için fastcgi_read_timeout) ile artırabilirsiniz. Yavaş bir istek yine de 502 ile bitebilir: PHP'nin max_execution_time değeri ya da havuzdaki request_terminate_timeout işçiyi önce sonlandırırsa Nginx günlüğe upstream prematurely closed connection yazar. Asıl çözüm yavaş kodu ya da sorguyu düzeltmektir; uzun zaman aşımları sorunu yalnızca gizler.

AlmaLinux'ta SELinux

AlmaLinux ve diğer RHEL tabanlı sistemlerde SELinux, Nginx'in bir uygulamaya ağ bağlantısı açmasına varsayılan olarak izin vermez. Uygulama çalıştığı hâlde günlükte connect() to 127.0.0.1:3000 failed (13: Permission denied) görünür. Kalıcı olarak izin verin:

sudo setsebool -P httpd_can_network_connect 1

Bunu çözmek için SELinux'u tamamen kapatmayın; bu tek ayar yeterlidir.

Apache mod_proxy

Reverse proxy olarak Apache kullanıyorsanız günlük dosyası /var/log/apache2/error.log (AlmaLinux'ta /var/log/httpd/error_log) olur. AH01102: error reading status line from remote server gibi bir mesaj, arka uç sunucunun geçersiz bir yanıt verdiğini ya da bağlantıyı kapattığını gösterir. Apache'nin bağlantıyı reddeden bir arka ucu genellikle 502 değil 503 olarak bildirdiğini unutmayın. Kontroller aynıdır: Arka uç çalışıyor mu, ProxyPass satırındaki adres ve port doğru mu?

Cloudflare'de 502 hatası

Siteniz Cloudflare arkasındaysa önce hata sayfasına bakın. Cloudflare markalı bir 502 ya da 504 sayfası Cloudflare ağındaki bir soruna işaret eder; durum sayfalarını kontrol edin. Altında nginx yazan sade bir sayfa ise kendi sunucunuzdan gelir ve yukarıdaki tüm adımlar geçerlidir. Cloudflare'in kendi kodları daha açıklayıcıdır: 521 web sunucunuzun bağlantıyı reddettiğini, 522 ise bağlantının zaman aşımına uğradığını gösterir; bunun sebebi çoğu zaman Cloudflare IP aralıklarını engelleyen bir güvenlik duvarıdır.

Kaynak sunucuyu Cloudflare olmadan test etmek için isteği doğrudan sunucunun IP adresine gönderin:

curl -I --resolve alanadiniz.com:443:203.0.113.10 https://alanadiniz.com

Docker: konteyner adı, port ve ağ

Nginx bir konteynerde çalışıyorsa 127.0.0.1 uygulamanızı değil, Nginx konteynerinin kendisini ifade eder. İkisini aynı Docker ağına koyun ve servis adını, uygulamanın konteyner içinde dinlediği portla birlikte kullanın:

proxy_pass http://app:3000;

Uygulama konteyner içinde yalnızca 127.0.0.1 üzerinde değil, 0.0.0.0 üzerinde dinlemelidir. Konteynerin çalıştığını docker ps ve docker logs app ile kontrol edin. Nginx adı başlangıçta çözdüğü için uygulama konteyneri yeni bir IP ile yeniden oluşturulduğunda Nginx'i de yeniden yükleyin. Nginx ana makinede çalışıyorsa portu yayınlayın (örneğin -p 127.0.0.1:3000:3000) ve 127.0.0.1:3000 adresine yönlendirin. Docker'ın temelleri Docker kurulumu rehberimizde.

Paylaşımlı hosting

Paylaşımlı hostingde proxy'yi ve PHP-FPM'i siz yönetmezsiniz; bu yüzden 502 genellikle hesabınızın kaynak sınırlarına (CPU, bellek ya da giriş süreçleri) ulaşmasından ya da sağlayıcı tarafındaki bir sorundan kaynaklanır. cPanel'deki Resource Usage (Kaynak Kullanımı) sayfasına ve hata günlüğüne bakın, son eklediğiniz eklentileri devre dışı bırakın ve hata sürerse görüldüğü saati belirterek destek ekibine yazın.

Nginx'i test edin ve yeniden yükleyin

Her yapılandırma değişikliğinden sonra, bir yazım hatasının tüm sitelerinizi kapatmaması için yeniden yüklemeden önce test edin:

sudo nginx -t
sudo systemctl reload nginx

Hızlı kontrol listesi

KontrolKomut ya da yer
Nginx ne diyor?sudo tail -n 50 /var/log/nginx/error.log
Arka uç çalışıyor mu?systemctl status php8.3-fpm, pm2 status
Adres eşleşiyor mu?ss -tlnp, ls /run/php/ ve proxy_pass
FPM havuzu dolu mu?/var/log/php8.3-fpm.log içinde max_children
Bir süreç sonlandırıldı mı?dmesg -T içinde Killed process
Yalnızca AlmaLinuxsetsebool -P httpd_can_network_connect 1
Cloudflare arkasında mı?Markalı sayfa mı, kaynak sayfası mı, curl --resolve
Yapılandırma geçerli mi?nginx -t, ardından systemctl reload nginx

Nginx yapılandırmasında yeni misiniz? Nginx kurulumu rehberimiz server bloklarını ve reverse proxy kurulumunu baştan anlatıyor.

Nodesty'de 502 hatalarını çözmek

Nodesty AMD Ryzen 9 9950X VDS paketlerinde tam root erişiminiz olduğu için tüm günlükleri okuyabilir, PHP-FPM ve Nginx ayarlarını yapabilir ve servisleri kendiniz yeniden başlatabilirsiniz; NVMe disk ve 7 gün saklanan ücretsiz günlük yedekler de pakete dahildir. Sunucu yönetmek istemiyorsanız Nodesty web hosting paketleri sitelerinizi AMD Ryzen 9 7900 işlemcili sunucularda LiteSpeed web sunucusu, NVMe disk ve cPanel ya da DirectAdmin ile çalıştırır; kaynak kullanımını ve hata günlüklerini panelden görebilirsiniz.

Sıkça Sorulan Sorular

502 Bad Gateway ne demek?

Ağ geçidi ya da proxy görevi gören bir sunucu, genellikle Nginx, Cloudflare gibi bir CDN ya da yük dengeleyici, isteği arkasındaki sunucuya iletti ama geçerli bir yanıt alamadı demektir. Proxy'nin kendisi çalışır; arkadaki uygulama, PHP-FPM ya da konteyner kapalıdır, ulaşılamıyordur ya da proxy'nin kullanamayacağı bir yanıt vermiştir.

502 hatası ziyaretçiden kaynaklanır mı?

Hayır. 502 sunucu tarafı bir hatadır; önbelleği temizlemek ya da tarayıcı değiştirmek nadiren işe yarar. Ziyaretçi olarak yapabileceğiniz tek şey birkaç dakika bekleyip yeniden denemektir. Sitenin sahibiyseniz web sunucusunun hata günlüğü, proxy'nin uygulamaya neden ulaşamadığını gösterir.

502 ile 504 arasındaki fark nedir?

502'de proxy hiç geçerli yanıt alamamıştır; örneğin bağlantı reddedilmiş ya da uygulama istek sırasında çökmüştür. 504'te ise uygulama bağlantıyı kabul etmiş ama proxy'nin zaman aşımı süresi içinde yanıt vermemiştir. 502 genellikle kapalı ya da yanlış yapılandırılmış bir şeye, 504 ise fazla yavaş çalışan bir şeye işaret eder.

502 hatası neden bazen gelip gidiyor?

Aralıklı 502 hataları genellikle arka uç sunucunun yük altında kapasitesinin bitmesinden kaynaklanır. PHP-FPM pm.max_children sınırına ulaşır, bellek bitince uygulama sonlandırılıp yeniden başlar ya da bir konteyner sürekli yeniden başlar. Hatanın görüldüğü saatlerde PHP-FPM günlüğünü ve dmesg çıktısındaki out of memory mesajlarını kontrol edin.

502 hatası SEO'ya zarar verir mi?

Kısa bir kesinti zarar vermez. Arama motorları 5xx hatalarını geçici sayar ve sayfayı daha sonra yeniden dener. Ancak site günlerce 502 verirse tarama yavaşlar ve sayfalar zamanla dizinden düşebilir; bu yüzden tekrarlayan 502 hataları yeniden başlatmalarla değil, kaynağında çözülmelidir.

Paylaşımlı hostingde 502 alıyorum, ne yapabilirim?

Paylaşımlı hostingde web sunucusunu ve PHP-FPM'i siz yönetmezsiniz; sebep genellikle hesabınızın kaynak sınırları ya da sağlayıcı tarafındaki bir sorundur. Kontrol panelinizdeki kaynak kullanımı sayfasına ve hata günlüğüne bakın, yeni eklediğiniz bir eklentiyi devre dışı bırakın ve hatanın görüldüğü saati belirterek destek ekibine yazın.

Nodesty

Yazar hakkında

Nodesty Ekibi · Altyapı ve Destek

Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.

İlgili yazılar

Sunucunuzu şimdi başlatın.

Nodesty'nin üstün altyapısı ile projelerinizi özgürce inşa edin ve sınır tanımadan ölçeklendirin.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································