İçeriğe atla

Hydration mismatch yüzünden AI botuna eski veri mi gidiyor? 6 kontrolle SSR ve istemci HTML’sini karşılaştırın

SSR HTML ile JavaScript sonrası istemci DOM’u arasındaki hydration mismatch farkını gösteren teknik illüstrasyon

AI okunabilirliği, bir web sayfasındaki önemli bilgilerin yapay zeka ajanları tarafından doğru, güncel ve makinece anlaşılabilir biçimde alınabilmesidir. Örneğin ürün fiyatını sunucunun ürettiği HTML’de 1.299 TL, JavaScript çalıştıktan sonra tarayıcıda 1.249 TL görüyorsanız iki ayrı içerik katmanı oluşur. Kısa cevap: Hydration mismatch tek başına AI botuna mutlaka eski veri göndermez; ancak güncel bilgi yalnızca istemci tarafında yükleniyor veya SSR çıktısı önbellekte kalıyorsa bazı ajanlar ilk HTML’deki eski ya da eksik veriyi okuyabilir.

Bu nedenle hedef, yalnızca tarayıcıda doğru görünen bir sayfa üretmek değil, ham HTTP yanıtı, JavaScript kapalı görünüm ve JavaScript sonrası DOM arasındaki farkı ölçmektir. AI sistemlerinin tümü aynı tarama yöntemini kullanmaz: bazıları yalnızca HTTP yanıtını işler, bazıları JavaScript çalıştıran bir tarayıcı kullanabilir. Hangi katmanın okunduğunu varsaymak yerine 6 kontrolü aynı URL üzerinde uygulayın.

Hydration mismatch AI botuna eski veriyi nasıl ulaştırır?

Hydration mismatch, sunucu HTML’si ile React’in istemcideki ilk render çıktısı farklı olduğunda oluşur. Eski veri riski ise çoğunlukla stale SSR önbelleği, istemci tarafında yapılan veri çekimi veya zamanla değişen değerlerin birleşiminden doğar. Bu yüzden mismatch bir belirti, veri akışındaki tutarsızlık ise asıl inceleme alanıdır.

SSR, sunucunun tarayıcıya gönderdiği ilk HTML’dir. Bu HTML, JavaScript hiç çalışmadan da görülebilen içeriktir. Hydration sırasında React bu işaretlemeye olay dinleyicileri bağlar ve kendi sanal ağacıyla eşleştirme yapar. İlk istemci render’ı sunucudaki metin, nitelik veya düğüm yapısından farklıysa konsolda hata ya da uyarı oluşabilir. React bazı metin farklarını toparlayabilse de bu davranış, içeriğin tüm botlar için güncel kalacağı anlamına gelmez.

SSR ve istemci HTML farkını hangi 6 kontrolde bulabilirsiniz?

1. İlk HTTP yanıtında güncel veri var mı?

Önce JavaScript çalıştırmadan sunucunun ne gönderdiğini kaydedin. Yanıt gövdesinde başlık, fiyat, stok, tarih veya yapılandırılmış veri bulunmuyorsa JS çalışmadan içerik okunamaz. Yanıt eskiyse sorun hydration’dan önce, veri kaynağı ya da önbellek katmanındadır.

Komut satırında farklı User-Agent değerleriyle aynı URL’yi alın. User-Agent tek başına gerçek bir AI tarayıcısını taklit etmez; yine de CDN veya sunucu kurallarının farklı yanıt verip vermediğini gösterebilir.

curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html

2. View Source ile canlı DOM arasında ne değişiyor?

Tarayıcıdaki View Source, büyük ölçüde sunucudan gelen kaynak HTML’yi; Elements paneli ise JavaScript sonrası canlı DOM’u gösterir. Bu iki çıktıyı ayrı ayrı kaydedin ve önemli içerik düğümlerini karşılaştırın. Fiyat, açıklama, tarih ve JSON-LD içindeki değerler aynı değilse farkın kaynağını işaretleyin.

Bir farkın varlığı her zaman SEO hatası değildir. Örneğin React’in olay dinleyicisi bağlaması görünür metni değiştirmez. Buna karşılık sunucuda bulunan bir stok metninin istemcide kaldırılması veya yalnızca istemcide eklenmesi AI okunabilirliğini doğrudan etkileyebilir.

3. React hydration hatası hangi bileşende oluşuyor?

Tarayıcı konsolundaki hydration uyarısını ve component stack bilgisini kaydedin. React 18 ve sonraki sürümlerde hydrateRoot için onRecoverableError kullanarak üretim ortamındaki olayları izleyebilirsiniz. Hatanın yalnızca log’u susturuluyorsa problem çözülmüş sayılmaz.

hydrateRoot(root, <App initialData={initialData} />, {
  onRecoverableError(error, info) {
    console.warn('Hydration farkı', error.message, info.componentStack);
  }
});

Hata mesajını URL, bileşen ve veri sürümüyle birlikte loglayın; kişisel veri göndermeyin. Bir sayfada aynı uyarı 3 farklı bileşende görülüyorsa ortak bir tarih formatı, locale veya başlangıç verisi üreticisi arayın.

4. Tarih, saat, locale veya rastgele değer ilk render’ı değiştiriyor mu?

Date.now(), Math.random(), tarayıcı saat dilimi, para biçimi ve window gibi kaynaklar sunucu ile istemcide farklı sonuçlar üretebilir. Sunucuda sabit bir ISO tarihini veya önceden biçimlendirilmiş etiketi üretin; istemcide değişken değeri hydration sonrasındaki useEffect içinde güncelleyin.

Örneğin sunucu UTC, tarayıcı ise Europe/Istanbul saat diliminde çalışıyorsa aynı zaman damgası farklı güne dönüşebilir. İlk HTML’de kesin bir tarih göstermeniz gerekiyorsa hem metni hem de veri sürümünü sunucudan istemciye aynı payload içinde taşıyın.

5. Güncel veri yalnızca istemci tarafındaki fetch ile mi geliyor?

Bir içerik useEffect içinde çekiliyorsa JavaScript kapalı istemcide ve yalnızca HTTP yanıtını okuyan ajanda görünmeyebilir. Kritik bilgi için ilk SSR yanıtına başlangıç verisini koyun. İstemci fetch’i son güncellemeyi alabilir; fakat ilk render aynı başlangıç değerinden başlamalıdır.

SSR’nin 10:00’da ürettiği ürün fiyatı ile istemcinin 10:01’de API’den aldığı fiyat farklıysa bu durum beklenen bir güncelleme olabilir. Ancak AI ajanı sadece ilk HTML’yi işliyorsa ikinci fiyatı hiç görmez. Bu farkı içerik kaynağı, üretim zamanı ve API yanıt zamanı ile birlikte raporlayın.

6. CDN, ISR veya uygulama önbelleği eski SSR çıktısını tutuyor mu?

Yanıt başlıklarındaki Age, ETag, Last-Modified, Cache-Control ve CDN’e özgü cache durumunu inceleyin. Sunucu veritabanından güncel fiyatı alsa bile CDN 300 saniyelik eski HTML döndürebilir. İçeriğin değiştiği anda purge, kısa revalidation veya uygun bir no-store politikası kullanın.

Önbelleği devre dışı bırakan rastgele sorgu parametresiyle yapılan test, gerçek ziyaretçi yolunu her zaman temsil etmez. Bu nedenle normal URL’yi 2 veya 3 farklı ağdan, aynı header’larla ve zaman damgası kaydı tutarak karşılaştırın. 200 yanıtın gövdesi farklıysa varyasyon kuralını da kontrol edin.

Teknik kontrol listesi

  • Sayfanın ham HTML’sini curl ile kaydedin; önemli metin, canonical ve JSON-LD alanlarını işaretleyin.
  • View Source çıktısını JavaScript sonrası Elements DOM’u ile karşılaştırın; yalnızca sınıf veya olay bağlayıcısı değil, görünür içerik farklarını ayırın.
  • JavaScript’i devre dışı bırakarak ürün, makale veya hizmet için gerekli bilgilerin okunabildiğini test edin.
  • React konsol uyarılarını URL, bileşen ve veri sürümüyle izleyin; suppressHydrationWarning kullanımını düzeltme yerine geçirmeyin.
  • Tarih, saat, locale ve rastgele değerleri ilk render’dan çıkarın veya sunucudan istemciye aynı değeri taşıyın.
  • CDN ve uygulama önbelleğinde TTL, ETag, revalidation ve purge akışını içerik güncelleme anında doğrulayın.

Örnek senaryo: ürün fiyatı SSR’de eski, DOM’da güncel

Bir e-ticaret sayfasında ERP, ürünü 1.249 TL’ye güncelliyor. Fakat CDN’in 300 saniyelik TTL’si nedeniyle sunucu 1.299 TL içeren HTML’yi döndürmeye devam ediyor. React bileşeni hydration sonrasında API çağrısı yapıyor ve tarayıcıda 1.249 TL gösteriyor. Kullanıcı Elements panelinde doğru fiyatı görürken, JS çalıştırmayan bir AI okuyucu ham HTML’de 1.299 TL bulabilir.

Doğru düzeltme, yalnızca hydration uyarısını kapatmak değildir. SSR’nin güncel kaynaktan veri almasını, CDN’in ERP güncellemesinden sonra temizlenmesini ve istemcinin aynı başlangıç değerini kullanmasını sağlayın. Aşağıdaki desen, sunucu etiketinin ilk istemci render’ında korunmasını; API yanıtı geldikten sonra kontrollü değişmesini sağlar:

function Price({ initialLabel, initialValue }) {
  const [price, setPrice] = useState({
    label: initialLabel,
    value: initialValue
  });

  useEffect(() => {
    fetch('/api/price/abc', { cache: 'no-store' })
      .then(response => response.json())
      .then(nextPrice => setPrice(nextPrice));
  }, []);

  return <p data-price={price.value}>{price.label}</p>;
}

Burada initialLabel ve initialValue SSR ile istemciye aynı aktarılmalıdır. API yanıtı örneğin { label: '1.249 TL', value: 1249 } biçiminde dönebilir. Test sırasında önce ssr.html dosyasını, sonra JavaScript etkin tarayıcıdaki DOM’u kaydedin; ardından diff -u ile yalnızca fiyat düğümünü değil, JSON-LD ve erişilebilirlik metinlerini de inceleyin.

Sayfa değişken veriyi gerçekten istemcide güncelliyorsa, bu güncellemenin ne zaman gerçekleştiğini ölçün. Örneğin 180 milisaniyede tamamlanan bir fetch tarayıcı kullanıcısı için görünür olabilir; fakat sunucu yanıtını hiç render etmeyen bir ajan bu süreyi yaşamaz. AI okunabilirliği açısından kritik bilgi ilk HTML’de bulunmalı ve oradaki değer geçerli veri politikanızla uyumlu olmalıdır.

Sık yapılan hatalar

  • Hydration uyarısını bastırmayı, eski veya eksik içeriği düzeltmek sanmak.
  • Yalnızca ekran görüntüsünü kontrol edip ham HTTP yanıtını hiç incelememek.
  • Fiyat, stok veya makale gövdesini yalnızca useEffect içindeki API çağrısına bırakmak.
  • Sunucu ve istemcide farklı locale, saat dilimi ya da para biçimi kullanmak.
  • CDN cache temizliğini doğrulamadan içerik güncellemesinin anında yayınlandığını varsaymak.
  • Bir tarayıcı botunun davranışını tüm AI ajanlarına genellemek.

Sonuç olarak hydration mismatch, önce SSR çıktısı ile istemcinin ilk render’ını karşılaştırmanız gereken bir sinyaldir. Eski verinin gerçekten AI botuna gidip gitmediğini anlamak için ham yanıtı, JavaScript kapalı görünümü, canlı DOM’u, React log’larını ve önbellek başlıklarını aynı URL üzerinde birlikte değerlendirin.

Sık sorulan sorular

Hydration mismatch her zaman AI botlarının eski veri okuduğu anlamına mı gelir?

Hayır. Mismatch, sunucu HTML’si ile istemcinin ilk render’ının farklı olduğunu gösterir. Fark yalnızca saat veya rastgele değer kaynaklı olabilir. Eski veri riski özellikle güncel içeriğin yalnızca istemcide yüklenmesi ya da SSR yanıtının önbellekte kalması durumunda artar.

JavaScript kapalıyken içerik görünmüyorsa ne yapılmalı?

Kritik başlık, açıklama, fiyat, stok veya makale gövdesini SSR ile ilk HTML’ye koyun. İstemci tarafındaki fetch yalnızca güncelleme için kullanılmalı ve ilk istemci render’ı sunucunun gönderdiği başlangıç verisiyle aynı olmalıdır.

suppressHydrationWarning kullanmak SEO sorununu çözer mi?

Genellikle çözmez. Bu özellik belirli bir hydration uyarısını bastırabilir; ancak ham HTML’nin eski veya eksik olmasını, CDN cache sorununu ya da yalnızca JavaScript sonrası gelen içeriği düzeltmez. Önce veri üretim ve önbellek akışını onarın.

SSR ile istemci HTML’si nasıl hızlı karşılaştırılır?

Önce curl ile ham yanıtı dosyaya kaydedin. Ardından JavaScript etkin tarayıcıdaki canlı DOM’u dışa aktarın ve iki dosyada kritik içerik düğümlerini diff ile karşılaştırın. View Source ve Elements panelinin farklı katmanları gösterdiğini unutmayın.

AI okunabilirliği kontrolünü başlatın: Sayfanızın ham SSR yanıtını, JavaScript kapalı görünümünü ve canlı DOM’unu karşılaştırarak eski veri riskini ölçün; tespit edilen farklar için teknik düzeltme planı oluşturun.