TR EN

Nginx 504 Gateway Time-out Hatası ve Çözümü

Nginx 504 Gateway Time-out hatası, Nginx'in arkasındaki backend servisinden (PHP-FPM, Python, Node.js veya veritabanı) belirlenen zaman aşımı süresi içinde yanıt alamaması durumunda oluşur.

Hatanın Nedeni ve Tetikleyici Faktörler

Nginx 504 Gateway Time-out hatası, Nginx'in arkasındaki backend servisinden (PHP-FPM, Python, Node.js veya veritabanı) belirlenen zaman aşımı süresi içinde yanıt alamaması durumunda oluşur.

  • PHP veya backend scriptinin Nginx'in varsayılan 60 saniyelik zaman aşımı süresinden daha uzun sürmesi.
  • Yavaş veya kilitlenmiş SQL sorgularının veritabanını meşgul etmesi.
  • PHP-FPM request_terminate_timeout sınırının aşılması.
  • Dış API çağrılarının yanıt vermeyip backend sürecini askıda bırakması.

Adım Adım Çözüm Rehberi

1. Nginx Zaman Aşımı Sürelerini Artırın

Nginx server veya location bloğuna aşağıdaki zaman aşımı değerlerini ekleyin:

fastcgi_read_timeout 300;
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_send_timeout 300;

2. PHP max_execution_time Değerini Yükseltin

php.ini dosyanızda çalışma süresini 300 saniyeye çıkarın:

max_execution_time = 300
max_input_time = 300

3. PHP-FPM www.conf Dosyasını Güncelleyin

/etc/php/8.3/fpm/pool.d/www.conf içinde şu ayarı yapın:

request_terminate_timeout = 300s

4. Servisleri Yeniden Başlatın

Yapılandırmaları test edip servisleri yeniden yükleyin:

sudo nginx -t
sudo systemctl restart php8.3-fpm
sudo systemctl reload nginx
💡 Canlı Tanılama Araçları: Sunucunuzdaki SSL, DNS ve HTTP yanıt başlıklarını SSL Kontrolü, Güvenlik Başlıkları veya Açık Port Testi araçlarımızla hemen test edebilirsiniz.

Diğer Popüler Hata Çözümleri

Laravel 419 Page Expired Hatası ve CSRF ÇözümüNginx 502 Bad Gateway Hatası Çözümü (PHP-FPM & Upstream)CORS Hatası Çözümü: No 'Access-Control-Allow-Origin' HeaderWordPress 500 Internal Server Error (Kritik Hata) ÇözümüERR_SSL_PROTOCOL_ERROR Hatası Nedir ve Nasıl Çözülür?ERR_TOO_MANY_REDIRECTS (Yönlendirme Döngüsü) ÇözümüWordPress 'Error Establishing a Database Connection' ÇözümüSSH Connection Refused (Port 22 Bağlantı Reddedildi) Çözümü

Sıkça Sorulan Sorular

502 ile 504 hatası arasındaki fark nedir?
502 Bad Gateway'de backend sunucusu hemen geçersiz veya çökme yanıtı döner. 504 Gateway Timeout'ta ise backend hiç yanıt veremez ve Nginx beklemekten vazgeçer (zaman aşımı).
Zaman aşımını 1000 saniye yapmak doğru mudur?
Hayır. Çok yüksek zaman aşımları sunucudaki tüm çalışan süreçlerin kilitlenmesine ve RAM'in tükenmesine yol açabilir. Asıl çözüm yavaş sorguları veya işlemleri optimize etmek ya da kuyruk (Queue) sistemine devretmektir.