503 Service Unavailable: Hizmet kullanılamıyor hatası

503 Service Unavailable, hizmetin o anda isteği karşılamaya hazır olmadığını bildirir. Planlı bakım, aşırı yük, çalışmayan uygulama işçileri veya arka hizmet sorunları bu yanıtı oluşturabilir. Doğru teşhis için yanıtın web sunucusundan mı, CDN’den mi yoksa uygulamadan mı geldiğini belirlemek gerekir. Her 503 hatası aynı kaynak artırımıyla çözülmez.

Yanıtı hangi katman veriyor?

Sayfanın görünümü ve yanıt başlıkları ilk ipuçlarını sağlayabilir, ancak tek başına kesin kanıt değildir. CDN günlükleri, ters vekil kaydı ve uygulama günlüğünü aynı zaman aralığında karşılaştırın. Arka uygulama durmuşken ön sunucu çalışmaya devam edebilir. Sunucuya ping atılabilmesi web uygulamasının sağlıklı olduğunu göstermez.

Hata yalnız belirli bir bölgede, oturum türünde veya URL’de görünüyorsa bunu not edin. Önbellekten sunulan sayfalar çalışırken dinamik sayfalar bozulabilir. Bu durum, ziyaretçinin gördüğü sonuçla arka uygulamanın sağlığı arasındaki farkı açıklayabilir. Tek ana sayfa testiyle bütün hizmeti sağlıklı saymayın.

Kontrol sırası

1. Bakım durumunu kontrol edin. Planlı yayın veya güncelleme sırasında bakım modu açılmış olabilir.
2. Uygulama hizmetini inceleyin. İlgili süreçlerin çalıştığını ve beklenen portta dinlediğini doğrulayın.
3. Kaynakları ölçün. CPU, kullanılabilir RAM, disk ve işçi/kuyruk sınırlarını birlikte değerlendirin.
4. Hata kayıtlarını eşleştirin. Bağlantı reddi, zaman aşımı ve süreç kapanması farklı nedenler gösterir.
5. Son değişikliği araştırın. Yayın, güvenlik duvarı veya bağlantı bilgisi değişmiş mi bakın.
6. Düzeltmeyi yük altında test edin. Yalnız tek isteğin başarılı olmasına değil tekrar eden isteklere bakın.

Yoğunluk kaynaklı hatalar

Gerçek trafik artışı, bot istekleri veya yavaş çalışan bir görev işçi havuzunu doldurabilir. Bekleyen isteklerin birikmesi daha çok eşzamanlı süreç açarak her zaman çözülmez; bellek tüketimi artıp sorun büyüyebilir. Uygulama yanıt süresi, yavaş sorgular ve önbellek kapsamı değerlendirilmelidir. Gerekirse yükü azaltan geçici önlemler, kapasite planıyla birlikte uygulanır.

Örneğin bir kampanyada ürün sayfaları önbellekten açılıyor ama sepet 503 veriyorsa sepetin dinamik bağımlılıkları incelenmelidir. Bütün siteye agresif önbellek açmak müşteri oturumlarını ve fiyat doğruluğunu etkileyebilir. Önbellek kuralı uygulamanın kişiselleştirilmiş sayfalarını dikkate almalıdır.

Planlı bakım yanıtı

Bakım sayfası sunulacaksa HTTP durumunun gerçekten 503 olması ve uygun olduğunda tahmini tekrar deneme bilgisinin Retry-After başlığıyla iletilmesi değerlendirilebilir. Tasarımda yalnız “bakımdayız” yazıp 200 döndürmek farklı bir anlam taşır. Tahmini süre belirsizse gerçekçi olmayan zaman sözü vermeyin. Bakım bittiğinde normal yanıtların döndüğünü ve önbelleğin eski sayfayı tutmadığını kontrol edin.

Yeniden başlatmadan önce

Kayıtları ve süreç durumunu koruyun. Sürekli yeniden başlatma hatayı kısa süreli gizleyip inceleme kanıtlarını azaltabilir. Hizmet yeniden açılıyorsa neden tekrar kapandığını araştırın: bellek yetersizliği, yapılandırma hatası veya dış bağımlılık olabilir. Üretim hizmetini yeniden başlatırken aktif işlemlerin ve kullanıcıların etkilenmesini hesaba katın.

Sık sorulan sorular

503 ile 500 aynı mı? Hayır. 503 hizmetin isteği karşılamaya hazır olmadığını belirtir; 500 daha genel bir sunucu hatasıdır.

Hosting yükseltmek şart mı? Önce darboğazı doğrulayın; yanlış yapılandırma veya durmuş süreç kaynak artırımıyla düzelmeyebilir.

Sorun çözüldükten sonra ne izlenmeli? Hata oranı, yanıt süresi, kuyruklar ve kaynak tüketimini benzer yoğunluk döneminde takip edin.

İlgili teknik kaynak

• MDN 503 Service Unavailable