504 Gateway Timeout Hatası Nasıl Çözülür

Son doğrulama: Eylül 2026 · cPanel 136 test hesabında denendi

504 Gateway Timeout hatası ne anlama gelir, neden olur?

HTTP 504 durum kodu, bir ağ geçidi ya da vekil sunucunun (örneğin Nginx ya da LiteSpeed ön ucu) arka uçtaki uygulamadan yanıtı belirlenen sürede alamadığını bildirir. Sayfa “çalışıyor” ama işlem çok uzun sürdüğü için ön uç beklemeyi keser. Yakın akrabası 502 Bad Gateway‘den farkı, 502’de arka uç geçersiz yanıt verirken 504’te hiç yanıt vermeden sürenin dolmasıdır.

Neden genelde şu başlıklardan birine çıkar: bir PHP betiği (büyük içe aktarma, yedek, rapor ya da yavaş bir veritabanı sorgusu) max_execution_time sınırını aşar; bir eklenti veya harici API çağrısı yanıt vermez; ya da kendi sunucunuzda Nginx/PHP-FPM zaman aşımı süreleri işlem için fazla kısadır. HTTP standardı (RFC 9110) bu kodu tam olarak bu durum için tanımlar. Önce hangi işlemin uzun sürdüğünü bulmak, körlemesine süre artırmaktan daha kalıcı bir çözümdür.

504 gateway timeout hatası nasıl çözülür — adım adım

Yöntem 1 — Paylaşımlı hostingde PHP zaman aşımını artırma (cPanel)

1. cPanel → Yazılım → MultiPHP INI Düzenleyici sayfasını açın, alan adınızı seçip max_execution_time değerini makul bir seviyeye (örneğin 120) çıkarın ve Uygula’ya basın.
   

   

2. Aynı işlem çok bellek kullanıyorsa memory_limit değerini de birlikte gözden geçirin; WordPress’te bellek sınırı ayrıca tanımlanabilir.

   Beklenen sonuç: yeni sınır uygulandıktan sonra süre aşımına uğrayan işlem tamamlanır ve 504 yerine normal yanıt döner.

WordPress bellek sınırını ayrıca yükseltmeniz gerekiyorsa WordPress memory limit artırma kartını izleyin.

Yöntem 2 — Yavaş işlemi bulup hızlandırma

Süreyi artırmak belirtiyi erteler; asıl çözüm işlemi hızlandırmaktır. cPanel Hatalar günlüğünden ve yavaş sorgu izlerinden hangi eklenti, sayfa ya da sorgunun uzun sürdüğünü bulun. Ağır bir işlem varsa küçük parçalara bölün, gereksiz eklentiyi kapatın ve sorguları optimize edin. Genel hız için site hızı nasıl artırılır kartına bakın.

Yöntem 3 — Kendi sunucunuzda (VPS/VDS) Nginx ve PHP-FPM zaman aşımı

Paylaşımlı hostingde SSH ve web sunucusu yapılandırması yoktur; bu ayar panelden yönetilir. Kendi VPS ya da VDS sunucunuzda Nginx’i PHP-FPM ile çalıştırıyorsanız zaman aşımı süreleri sizin sorumluluğunuzdadır. İlgili location bloğuna aşağıdaki satırları ekleyin.

# /etc/nginx/conf.d/site.conf içindeki location ~ \.php$ bloğuna
fastcgi_read_timeout 120;
proxy_read_timeout 120;

PHP-FPM tarafında da request_terminate_timeout değerini uyumlu tutun, ardından yapılandırmayı sınayıp servisi yeniden yükleyin.

sudo nginx -t
sudo systemctl reload nginx

Beklenen sonuç: nginx -t “syntax is ok” döndürür ve yeniden yükleme sonrası uzun işlem zaman aşımına uğramadan tamamlanır. Servisi yeniden başlatma adımları için Nginx nasıl yeniden başlatılır kartına bakabilirsiniz.

Doğrulama

Hâlâ çözülmediyse

• Süreyi artırdınız ama hata sürüyor. İşlem sınırın çok üstünde çalışıyor olabilir; yavaş sorguyu ya da eklentiyi hata günlüğünden bulup optimize edin.
• Benzer bir ağ geçidi hatası da görüyorsunuz. Neden aynı olabilir; 502 Bad Gateway ve 503 Service Unavailable kartlarına bakın.
• Bağlantı hiç kurulamıyor. Sorun farklı olabilir; ERR_CONNECTION_TIMED_OUT kartındaki adımları izleyin.