コンテンツへスキップ

Hydration mismatchでAIボットに古いデータが渡っていませんか?6つのチェックでSSRとクライアントHTMLを比較

Hydration mismatchでAIボットに古いデータが渡っていませんか?6つのチェックでSSRとクライアントHTMLを比較

AIの可読性とは、Webページ上の重要情報をAIエージェントが正確かつ最新の状態で、機械が理解しやすい形で取得できることです。たとえば、サーバーが生成したHTMLでは商品価格が1.299 TLなのに、JavaScript実行後のブラウザでは1.249 TLと表示されるなら、2つの異なるコンテンツ層が存在していることになります。結論から言うと、Hydration mismatchだけでAIボットに必ず古いデータが送られるわけではありません。しかし、最新情報がクライアント側だけで読み込まれていたり、SSRの出力がキャッシュに残っていたりすると、一部のエージェントは最初のHTMLにある古い、または不足した情報を読んでしまう可能性があります。

そのため、目指すべきなのは「ブラウザで正しく見えるページ」を作ることだけではありません。生のHTTPレスポンス、JavaScript無効時の表示、JavaScript実行後のDOMの差を測定することが重要です。AIシステムはすべて同じクロール方法を使うわけではありません。HTTPレスポンスだけを処理するものもあれば、JavaScriptを実行できるブラウザを使うものもあります。どの層が読まれているかを決め打ちせず、同じURLで6つのチェックを行ってください。

Hydration mismatchはどのようにしてAIボットに古いデータを届かせるのか?

Hydration mismatchは、サーバーHTMLとReactがクライアント側で最初に描画する出力が異なるときに発生します。古いデータのリスクは、多くの場合 stale SSRキャッシュ、クライアント側のデータ取得、時間とともに変わる値の組み合わせから生じます。つまり、mismatchは症状であり、実際に調べるべきなのはデータフローの不整合です。

SSRとは、サーバーがブラウザに送る最初のHTMLです。このHTMLは、JavaScriptが一切動かなくても表示できる内容です。hydrationの最中にReactはこのマークアップへイベントリスナーを紐づけ、独自の仮想ツリーと照合します。最初のクライアント描画が、サーバー側のテキスト、属性、ノード構造と異なっていれば、コンソールにエラーや警告が出ることがあります。Reactは一部のテキスト差分を吸収できることもありますが、それはコンテンツがすべてのボットに対して最新のままだと保証するものではありません。

SSRとクライアントHTMLの差は、どの6つのチェックで見つけられる?

1. 最初のHTTPレスポンスに最新データは入っているか?

まず、JavaScriptを実行せずにサーバーが何を返しているかを記録します。レスポンスボディに見出し、価格、在庫、日付、構造化データが含まれていなければ、JSなしでは内容を読むことができません。もしレスポンスが古いなら、問題はhydrationの前、つまりデータソースかキャッシュ層にあります。

コマンドラインでは、異なるUser-Agentで同じURLを取得してください。User-Agentだけで本物のAIクロールを完全に再現できるわけではありませんが、CDNやサーバーのルールが異なるレスポンスを返しているかどうかは確認できます。

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とライブDOMでは何が変わっているか?

ブラウザのView Sourceは、主にサーバーから届いた元のHTMLを示し、ElementsパネルはJavaScript後のライブDOMを表示します。この2つの出力をそれぞれ保存し、重要なコンテンツノードを比較してください。価格、説明、日付、JSON-LD内の値が一致しないなら、差分の原因を特定しましょう。

差分があること自体は、必ずしもSEOエラーではありません。たとえば、Reactがイベントリスナーを紐づけるだけなら、表示テキストは変わりません。一方で、サーバーにある在庫文言がクライアント側で削除されたり、クライアント側でしか追加されなかったりすると、AI可読性に直接影響します。

3. Reactのhydrationエラーはどのコンポーネントで起きているか?

ブラウザコンソールのhydration警告とcomponent stack情報を保存してください。React 18以降では、hydrateRootに対してonRecoverableErrorを使うことで、本番環境のイベントを監視できます。エラーのログを消しただけでは、問題が解決したことにはなりません。

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

エラーメッセージは、URL、コンポーネント、データバージョンとあわせてログに残してください。個人データは送らないでください。1つのページで同じ警告が3つの異なるコンポーネントに出るなら、共通の日時フォーマット、locale、または初期データ生成元を探しましょう。

4. 日付、時刻、locale、ランダム値が最初の描画を変えていないか?

Date.now()、Math.random()、ブラウザのタイムゾーン、通貨表記、windowのようなソースは、サーバーとクライアントで異なる結果を生むことがあります。サーバーでは固定のISO日付、または事前に整形したラベルを出力し、クライアント側では変動値をhydration後のuseEffectで更新してください。

たとえば、サーバーがUTC、ブラウザがEurope/Istanbulのタイムゾーンで動いている場合、同じタイムスタンプでも別の日付に変わることがあります。初期HTMLで確実に日付を出したいなら、テキストとデータバージョンの両方をサーバーからクライアントへ同じpayloadで運んでください。

5. 最新データはクライアント側のfetchだけで取得していないか?

コンテンツがuseEffectの中で取得されているなら、JavaScript無効のクライアントや、HTTPレスポンスだけを読むエージェントには見えない場合があります。重要な情報は、最初のSSRレスポンスに初期データとして含めてください。クライアントのfetchは最終更新を取りに行くためのものにできますが、最初の描画は同じ初期値から始まる必要があります。

SSRが10:00に生成した商品価格と、クライアントが10:01にAPIから取得した価格が異なる場合、それは想定された更新かもしれません。ただし、AIエージェントが最初のHTMLしか処理しないなら、2つ目の価格は一度も見ません。この差は、コンテンツソース、生成時刻、APIレスポンス時刻とあわせて報告してください。

6. CDN、ISR、アプリケーションキャッシュが古いSSR出力を保持していないか?

レスポンスヘッダーのAge、ETag、Last-Modified、Cache-Control、およびCDN固有のキャッシュ状態を確認してください。サーバーがデータベースから最新価格を取得していても、CDNが300秒前の古いHTMLを返していることがあります。コンテンツが変わったタイミングで、purge、短いrevalidation、または適切なno-storeポリシーを使ってください。

キャッシュを無効にするランダムなクエリパラメータでのテストは、実際の訪問者経路をいつも表すわけではありません。そのため、通常のURLを2〜3種類のネットワークから、同じヘッダーで、タイムスタンプを記録しながら比較してください。200レスポンスのボディが異なるなら、variationルールも確認しましょう。

技術チェックリスト

  • ページの生HTMLをcurlで保存し、重要なテキスト、canonical、JSON-LDの各フィールドを確認する。
  • View Sourceの出力を、JavaScript後のElements DOMと比較し、クラス名やイベントバインダーだけでなく、表示コンテンツの差分を分けて見る。
  • JavaScriptを無効にして、商品、記事、サービスに必要な情報が読めるかをテストする。
  • Reactのコンソール警告をURL、コンポーネント、データバージョンとあわせて追跡し、suppressHydrationWarningを修正の代わりにしない。
  • 日付、時刻、locale、ランダム値を最初の描画から外すか、サーバーからクライアントへ同じ値を渡す。
  • CDNとアプリケーションキャッシュで、TTL、ETag、revalidation、purgeの流れをコンテンツ更新時に検証する。

例: 商品価格はSSRでは古いが、DOMでは最新

あるECページで、ERPが商品価格を1.249 TLに更新したとします。しかし、CDNの300秒TTLのために、サーバーは1.299 TLを含むHTMLを返し続けています。Reactコンポーネントはhydration後にAPIを呼び出し、ブラウザでは1.249 TLが表示されます。ユーザーはElementsパネルで正しい価格を見られますが、JavaScriptを実行しないAIリーダーは生のHTMLで1.299 TLを見つけるかもしれません。

正しい修正は、hydration警告を消すことではありません。SSRが最新ソースからデータを取得し、ERP更新後にCDNをクリアし、クライアントが同じ初期値を使うようにしてください。次のパターンは、サーバーのラベルが最初のクライアント描画で維持され、APIレスポンス到着後に制御された形で変更されるようにします。

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>;
}

ここではinitialLabelとinitialValueを、SSRとクライアントで同じように渡す必要があります。APIレスポンスは、たとえば{ label: '1.249 TL', value: 1249 }の形式で返せます。テストではまずssr.htmlファイルを保存し、次にJavaScript有効のブラウザでDOMを保存してください。そのうえでdiff -uを使い、価格ノードだけでなく、JSON-LDとアクセシビリティ用テキストも確認します。

ページが変動データを本当にクライアント側で更新するなら、その更新がいつ起きるかを計測してください。たとえば180ミリ秒で完了するfetchは、ブラウザ利用者には見えるかもしれませんが、サーバーレスポンスを一切描画しないエージェントにはその時間は存在しません。AI可読性の観点では、重要情報は最初のHTMLに含まれているべきであり、その値は現在のデータポリシーと一致している必要があります。

よくある間違い

  • Hydration警告を消すことを、古い、または不足した内容の修正だと思い込む。
  • 画面のスクリーンショットだけを確認し、生のHTTPレスポンスを一切見ない。
  • 価格、在庫、記事本文をuseEffect内のAPI呼び出しだけに任せる。
  • サーバーとクライアントで異なるlocale、タイムゾーン、通貨表記を使う。
  • CDNキャッシュの削除を確認せずに、コンテンツ更新が即時反映されたと決めつける。
  • あるブラウザボットの挙動を、すべてのAIエージェントに一般化する。

結論として、Hydration mismatchは、まずSSR出力とクライアントの最初の描画を比較すべきだというシグナルです。古いデータが本当にAIボットに届いているかを見極めるには、生のレスポンス、JavaScript無効時の表示、ライブDOM、Reactログ、キャッシュヘッダーを同じURL上でまとめて評価してください。

よくある質問

Hydration mismatchは、常にAIボットが古いデータを読んでいることを意味しますか?

いいえ。mismatchは、サーバーHTMLとクライアントの最初の描画が異なることを示します。差分が単なる時刻やランダム値の影響である場合もあります。古いデータのリスクは、特に最新コンテンツがクライアント側だけで読み込まれる場合や、SSRレスポンスがキャッシュに残っている場合に高まります。

JavaScriptを無効にしたときに内容が見えない場合はどうすべきですか?

重要な見出し、説明、価格、在庫、記事本文をSSRで最初のHTMLに含めてください。クライアント側のfetchは更新用にのみ使い、最初のクライアント描画はサーバーが送った初期データと同じである必要があります。

suppressHydrationWarningを使えばSEOの問題は解決しますか?

通常は解決しません。この機能は特定のhydration警告を抑えられますが、生HTMLが古い、または不足している問題、CDNキャッシュの問題、JavaScript後にしか現れないコンテンツを直すものではありません。まずデータ生成とキャッシュの流れを修正してください。

SSRとクライアントHTMLを素早く比較するにはどうすればいいですか?

まずcurlで生のレスポンスをファイルに保存します。次に、JavaScript有効のブラウザでライブDOMをエクスポートし、2つのファイルの重要なコンテンツノードをdiffで比較してください。View SourceとElementsパネルが異なる層を示していることを忘れないでください。

サイトを無料でスキャン