Sayfa açılmaya çalışıyor, tarayıcıdaki yükleme çubuğu dönüp duruyor ve bir süre sonra ‘504 Gateway Timeout’ yazısıyla karşılaşıyorsunuz. Sitenin kapandığı falan yok. Sunucu bir yanıt üretmeye çalıştı ama verilen süre içinde yetiştiremedi, bekleyen kapı da sabrını tüketip pes etti.
İşin mantığı 502 ile benzer ama kök sebep farklı. 504’te arka taraftaki PHP işçisi çökmez, aksine çalışmaya devam eder. Sadece çok yavaştır. Ön kapı (Nginx, Apache ya da Cloudflare gibi bir proxy) belli bir süre bekler, o süre dolunca ‘bu iş uzadı’ deyip zaman aşımı döndürür. Yani asıl sorun hız. Bir yerde işler olması gerekenden çok uzun sürüyor.
Bu hataya ne sebep olur
- Ağır ve uzun süren bir işlem. İçe aktarma, büyük yedek alma, toplu ürün güncelleme gibi tek seferde çok şey yapan işler başı çeker.
- Düşük ayarlanmış max_execution_time değeri. Script daha bitmeden sunucu süreyi kesiyordur.
- Yavaş çalışan bir eklenti ya da kötü yazılmış bir veritabanı sorgusu
- Önünüzdeki CDN ya da proxy’nin zaman aşımı süresinin kısa olması
- Sunucunun o anki yükü kaldıracak kaynağının olmaması
Çözüm için sırayla
- Hata ağır bir işlem sırasında çıkıyorsa (örneğin binlerce satırlık bir içe aktarma), işi parçalara bölün. Büyük dosyayı küçük dosyalara ayırıp birer birer yükleyin. Çoğu içe aktarma eklentisi zaten parçalı çalışma seçeneği sunar.
- PHP’nin max_execution_time değerini yükseltin. Hosting panelinizde PHP ayarları varsa oradan 300 saniye gibi bir değere çekebilirsiniz. php.ini dosyasına erişiminiz varsa max_execution_time satırını orada düzenleyebilirsiniz.
- Bir CDN kullanıyorsanız onun zaman aşımı ayarına bakın. Cloudflare gibi servislerde bu süre sabittir ve uzun işlemler için yetmeyebilir. Ağır işlemi CDN’i geçici bypass ederek doğrudan sunucuda çalıştırmayı deneyin.
- Yavaş eklentiyi bulun. Eklentileri FTP ile tek tek pasif ederek ya da bir sorgu izleme eklentisiyle hangisinin sayfayı yavaşlattığını tespit edin. Çoğu zaman tek bir eklenti bütün yükü tek başına üretir.
- Veritabanı yavaşsa tabloları optimize etmek işe yarayabilir. Şişmiş gözden geçirme kayıtları, biriken geçici veriler ve spam yorumlar sorguları yavaşlatır.
- Bunlar yetmezse hosting desteğine danışın. Sunucunun kaynakları siteniz için dar kalmış olabilir. Hangi işlemin ne zaman uzadığını anlatmanız onların işini kolaylaştırır.
Küçük bir uyarı. max_execution_time değerini sınırsıza yakın yükseltmek her sorunu çözmez, bazen sadece sorunu gizler. Asıl amaç işlemi hızlandırmak olmalı, süreyi uzatmak son çare. Çünkü on dakika süren bir sayfa zaten sağlıklı çalışmıyor demektir.
Hatanın nerede çıktığı da ipucu verir. 504 yalnızca sitenin ön yüzünde, belirli bir sayfada çıkıyorsa o sayfadaki bir sorgu ya da eklenti yavaş çalışıyordur. Yönetim panelinde, özellikle içe aktarma ya da güncelleme ekranlarında çıkıyorsa iş genelde o ağır işlemin kendisindedir. Ziyaretçiler siteye hiç ulaşamıyor ve her sayfada aynı hata dönüyorsa, büyük ihtimalle sunucu ya da önündeki proxy genel bir tıkanma yaşıyordur. Nerede çıktığını not etmek, hangi adımdan başlayacağınızı baştan belli eder.
Yeniden yaşamamak için
Büyük içe aktarma ve yedekleme işlerini hep parçalı yapmayı alışkanlık edinin. Veritabanınızı düzenli aralıklarla temizleyin, biriken gereksiz kayıtları silin. Çok fazla eklenti yüklemek yerine gerçekten ihtiyacınız olanları tutun, çünkü her eklenti sayfa yükünde bir pay alır. Siteniz sürekli zaman aşımına düşüyorsa barındırma paketinizin kaynakları yetersiz olabilir, daha geniş bir plana bakmak mantıklı olur.
504 genelde bir hız problemidir ve hızı iyileştirmek ziyaretçi deneyimine de yarar. İş sunucu ayarlarına ve veritabanı optimizasyonuna uzanıp kendi başınıza çözemediğiniz bir noktaya geldiyse, bir uzmandan destek almak hem zaman kazandırır hem de kalıcı bir çözüm getirir.
Bu işleri kendiniz yapmak yerine profesyonel destek isterseniz, WordPress bakım ve teknik destek hizmetime göz atabilirsiniz.
Bu konunun tüm rehberi: WordPress Hataları ve Çözümleri