Nginx 502 Bad Gateway Hatası: Nedir ve Nasıl Çözülür?

Web sitenizi açtınız, her şey yolunda görünüyordu ama birden "502 Bad Gateway" hatası ile karşılaştınız. Sadece bir hata değil, bu, tüm kullanıcı deneyimini etkileyen bir sorun. Peki, bu hata ne anlama gelir ve nasıl düzeltilir? İşte size Nginx 502 Bad Gateway hatasının tüm detayları.

Nginx, web sitenizin ön yüzünü taşıyan güçlü bir web sunucusudur. Bir kullanıcının siteye giriş yapmak istemesi durumunda, Nginx bu isteği arka uçta çalışan uygulamanıza ileterek yanıt alır. Ancak bazen işler ters gidebilir ve bir "502 Bad Gateway" hatası alırsınız.

Bu hata, Nginx'in arka uç sunucusuna (genellikle bir uygulama sunucusu veya veritabanı) ulaşamadığını gösterir. Yani, Nginx isteği iletmiş fakat arka uç sunucusu yanıt verememiştir. Bunun pek çok nedeni olabilir.

1. Arka Uç Sunucusunun Çökmesi:

Uygulamanız veya veritabanınız çökmüş olabilir. Nginx bir şey almak istiyor ama alamıyor. Bu durumda, ilgili servisi kontrol edip yeniden başlatmak gerekebilir.

2. Yanıt Süresi Aşımı:

Eğer sunucunuz beklenenden daha uzun sürede yanıt veriyorsa, Nginx bu süreyi aşıp zaman aşımına uğrar ve 502 hatası alırsınız. Bu genellikle yoğun trafik sırasında yaşanır.

3. Yanlış Yapılandırılmış Proxy Ayarları:

Eğer Nginx, doğru IP adresine veya porta yönlendirme yapmazsa, 502 hatası alırsınız. Bu tür yapılandırma hataları, yanlış ayarlanmış proxy_pass parametrelerinden kaynaklanabilir.

####

1. Sunucuyu Yeniden Başlatın

Bazen çözüm basit olabilir. Sunucunuzun yeniden başlatılması, geçici sorunları çözebilir. Bunu yapmak için aşağıdaki komutu kullanabilirsiniz:

sudo systemctl restart nginx

Eğer uygulama sunucusunda sorun varsa, onu da yeniden başlatmak faydalı olabilir. Örneğin, PHP-FPM kullanıyorsanız, aşağıdaki komutu çalıştırabilirsiniz:

sudo systemctl restart php7.4-fpm

cat /var/log/nginx/error.log

Eğer loglarda bir hata mesajı görüyorsanız, o mesajı çözüm arayışınızda kullanabilirsiniz.

http {
    server {
        location / {
            proxy_pass http://localhost:8080;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_read_timeout 90;
        }
    }
}

Bu ayarlar, hem doğru yönlendirmeyi sağlar hem de zaman aşımı sorunlarını azaltabilir.

Aşağıdaki komutlarla PHP-FPM'in durumunu kontrol edebilirsiniz:

sudo systemctl status php7.4-fpm

Eğer uygulama sunucusu yanıt vermiyorsa, sunucuyu yeniden başlatmanız gerekebilir.

Unutmayın, Nginx 502 Bad Gateway hatası genellikle yapılandırma hatalarından ya da sunucu yanıtı verememesi nedeniyle oluşur. Çoğu zaman, çözüm basittir ve yukarıda önerdiğimiz adımları izleyerek hatayı çözebilirsiniz. Ancak sorununuz devam ediyorsa, sunucunuzun donanım kaynaklarını ve ağ yapılandırmasını gözden geçirmek gerekebilir.

Umarım bu yazı, Nginx 502 Bad Gateway hatasını anlamanızı ve çözmenizi kolaylaştırmıştır. Artık site ziyaretçileriniz hata mesajı görmek yerine, hızla içeriğinizi görüntüleyebilecekler!