Sorun çözümleri

React SPA sitesinde “Sunucu hatası (5xx)” hatası nasıl çözülür?

React SPA sitenizde Search Console'da “Sunucu hatası (5xx)” durumunu görüyorsanız doğru yerdesiniz. Sunucu Googlebot'a 5xx hata kodu döndürdü. Bu sayfa React SPA için nedenleri ve adım adım düzeltmeyi anlatır. Yalnızca tarayıcıda çalışan React uygulaması (Create React App, Vite). İçerik JavaScript ile çizildiği için Google'ın işleme sırasına bağımlısınız; ön oluşturma ya da sunucu tarafı üretim önerilir.

Güncelleme: 19.11.2026 · 2 dk okuma · English

İçindekiler
  1. Bu durum ne anlama gelir?
  2. React SPA sitelerinde olası nedenler
  3. React SPA üzerinde adım adım düzeltme
  4. React SPA için ek kontroller
  5. Düzelttikten sonra
  6. Daha fazla bilgi

Bu durum ne anlama gelir?

Googlebot isteğine sunucu 500, 502, 503 gibi bir hata ile yanıt verdi. Hatalar sürerse Google tarama hızını düşürür ve adresleri dizinden çıkarmaya başlayabilir.

React SPA sitelerinde olası nedenler

  • Sunucu aşırı yüklenmiş ya da kaynak limitine ulaşmış.
  • Uygulama kodunda belirli adreslerde çöken bir hata var.
  • Güvenlik duvarı, hız sınırı ya da bot koruması Googlebot'u engelliyor.
  • Bakım ya da dağıtım sırasında geçici kesinti yaşandı.
  • React SPA notu: Büyük JS paketi, işlemeyi geciktirir. Kod bölme, tembel yükleme ve önbellekleme kullanın; mümkünse kritik sayfaları sunucuda ön oluşturun.

React SPA üzerinde adım adım düzeltme

  1. React SPA yönetiminde şuraya gidin: public/index.html, react-helmet ya da benzeri bir başlık yönetimi, public/robots.txt ve sunucu yönlendirme ayarları.
  2. Büyük JS paketi, işlemeyi geciktirir. Kod bölme, tembel yükleme ve önbellekleme kullanın; mümkünse kritik sayfaları sunucuda ön oluşturun.
  3. Sunucu hata günlüklerinde Googlebot istek saatlerindeki 5xx kayıtlarını bulun ve nedenini giderin.
  4. Güvenlik duvarı ve CDN kurallarında Googlebot'un engellenmediğini doğrulayın.
  5. Planlı bakımda 503 ve Retry-After başlığı kullanın, 200 ile boş sayfa göstermeyin.
  6. Sunucu kapasitesini ve önbelleği artırın; Search Console tarama istatistiklerinde sunucu hatası oranını izleyin.
  7. Sorun çözülünce doğrulamayı başlatın ve önemli adresleri yeniden gönderin.

React SPA için ek kontroller

  • noindex ve görünürlük: index.html içinde unutulmuş bir noindex etiketi bütün rotaları etkiler. İstemci tarafında noindex ekleyip kaldıran kodlar Google'ın işlemesinden sonra bile tutarsız sonuç verebilir; noindex'i HTML'de sabit tutun.
  • robots.txt: public/robots.txt dosyasını ekleyin; yoksa birçok sunucu kurulumu index.html döndürüp robots.txt yerine HTML sunar. /static klasörünü ve JS dosyalarını engellemeyin, Google sayfayı işlemek için onlara ihtiyaç duyar.

Düzelttikten sonra

Search Console'da bu durum için "Düzeltmeyi doğrula" seçeneğini başlatın ve sayfayı URL denetimiyle yeniden gönderin. Önce ücretsiz Ücretsiz indekslenebilirlik kontrolü ile engelin kalktığını doğrulayın; çok sayıda adres için Toplu URL indeksleme: binlerce sayfa Google'a nasıl gönderilir? akışını izleyin. Google dizine alma kararını kendisi verir, süre günlerden haftalara değişebilir.

Daha fazla bilgi

Sık sorulan sorular

Geçici bir 5xx sorun yaratır mı?

Kısa süreli kesinti Google tarafından tolere edilir. Günlerce süren hata dizin kaybına yol açabilir.

Googlebot'u sunucum engelliyor mu nasıl anlarım?

Search Console'daki URL denetiminde canlı test yapın; hata alıyorsanız ve siteniz tarayıcıda açılıyorsa engelleme olasılığı yüksektir.

React SPA'da bu ayarlar nerede?

public/index.html, react-helmet ya da benzeri bir başlık yönetimi, public/robots.txt ve sunucu yönlendirme ayarları.

İlgili sayfalar