Sorun çözümleri

Next.js sitesinde “Sunucu hatası (5xx)” hatası nasıl çözülür?

Next.js 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 Next.js için nedenleri ve adım adım düzeltmeyi anlatır. React tabanlı çatı. Sunucu tarafı üretim ve statik üretim Googlebot'a hazır HTML verir; meta veriler Metadata API ile yönetilir.

Güncelleme: 15.11.2026 · 2 dk okuma · English

İçindekiler
  1. Bu durum ne anlama gelir?
  2. Next.js sitelerinde olası nedenler
  3. Next.js üzerinde adım adım düzeltme
  4. Next.js 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.

Next.js 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ı.
  • Next.js notu: Sayfaları mümkün olduğunca statik ya da ISR ile üretin; ağır istemci paketlerini bölün ve next/image kullanın. Yavaş sunucu yanıtı tarama hızını düşürür.

Next.js üzerinde adım adım düzeltme

  1. Next.js yönetiminde şuraya gidin: app/layout.tsx ve sayfa dosyalarındaki metadata nesnesi, app/robots.ts, app/sitemap.ts ve next.config.js.
  2. Sayfaları mümkün olduğunca statik ya da ISR ile üretin; ağır istemci paketlerini bölün ve next/image kullanın. Yavaş sunucu yanıtı tarama hızını düşürür.
  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.

Next.js için ek kontroller

  • robots.txt: app/robots.ts ya da public/robots.txt dosyasını kontrol edin. Önizleme ortamlarını Disallow ile kapatırken aynı kuralın üretime taşınmadığını doğrulayın.
  • canonical ve kopya adresler: metadata.alternates.canonical ile her sayfaya mutlak canonical verin ve metadataBase tanımlayın. Dinamik rotalarda parametreli adreslerin aynı içeriği tekrarlamadığına bakın.

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.

Next.js'da bu ayarlar nerede?

app/layout.tsx ve sayfa dosyalarındaki metadata nesnesi, app/robots.ts, app/sitemap.ts ve next.config.js.

İlgili sayfalar