本文へ移動
← 記事一覧

Next.js の RSC を CDN でキャッシュするとき、URL だけでは足りない理由

同じパスでも、ブラウザーが HTML ドキュメントを求める場合と、App Router がページ遷移用のデータを求める場合があります。両方を区別せず、URL だけで同じキャッシュへ保存すると、間違った形式を返すおそれがあります。

Next.js の配信では、人が見る URL だけではなく、フレームワークが扱うリクエストの違いを保つ必要があります。「GET は全部キャッシュする」だけでは安全な設定になりません。

パスはリクエストの一部にすぎない

商品ページの URL をアドレスバーに入力して開く場合と、アプリ内のリンクから同じ商品へ移る場合では、必要なレスポンスが違うことがあります。

Next.js の CDN キャッシュガイドで、現在のヘッダーやリクエスト形式の要件を確認します。HTTP 全般については Vary のリファレンスが、レスポンスが URL 以外の入力にも依存する理由を説明しています。

同じルートを表示するためのものでも、2つのレスポンスは交換可能なデータではありません。

キャッシュヒットが、不具合を示す場合もある

ページ遷移用のレスポンスが先に、パスだけをキーとするキャッシュへ入ったとします。後から直接アクセスした人に、そのレスポンスを返してしまうと、キャッシュ上はヒットでも、HTML として正しく表示できません。

逆の順番でも問題は起こり得ます。したがって、リクエストの種類だけでなく、どちらで先にキャッシュを作ったかも変えて試します。

検証は自分が管理する環境だけで行います。レスポンスをテスト用のファイルとして残す場合も、個人情報を含まないことを確認してください。

使っているバージョンの通信を取得する

古い記事のヘッダー一覧から、ページ遷移のリクエストを手作業で作らないでください。対象の Next.js とアダプターが実際に送っている通信をブラウザーで取得します。

リクエストヘッダー、クエリーパラメーター、レスポンスの Content-Type、ルーティングの動作を記録します。正規化や独自のキャッシュキーを設定する前に、対応する配信基盤のガイドを確認してください。

プロトコルは変わります。以前のバージョンで必要だった回避策が、新しいバージョンでは不要、または不正なこともあります。推測によるエッジのルールを増やすより、サポートされた連携方法を優先します。

クエリーを削るのは、表示を変え得る変更

計測専用のパラメーターを整理すると、再利用が増える場合があります。しかし、フレームワーク用のパラメーターまで計測用とは限りません。署名、アクセス権、表示内容の切り替えにも意味があります。

アプリが本当に無視してよいと確認したものだけを対象にし、意味が不明なパラメーターは残します。署名付き URL や認証済みリクエストから、未知の値を削らないでください。

単純な商品ページだけでなく、リダイレクトやインターセプトルートも試します。ホームで動いたルールが、ルーティング全体でも正しいとは限りません。

小さな組み合わせ表で検証する

1つのルートで、キャッシュがない状態の直接アクセス、キャッシュ後の直接アクセス、サイト内のページ遷移、プリフェッチ後のページ遷移を試します。キャッシュを作る順番も逆にして繰り返します。

Content-Type と画面上の結果の両方を確認します。存在しないページとリダイレクトされるページも加え、デプロイ後や無効化後も同じ確認を行ってください。

認証を使うアプリでは、2つの独立したテストセッションを追加します。配信の最適化によって、アクセス権が違うレスポンスが同じものになってはいけません。

CDN が再利用してよいのは、次のリクエストにもそのレスポンスが正しい場合だけです。速くても違う形式が届くなら、配信は壊れています。ヒット率の前に、ルートが返す形式と、それを区別する方法を確認します。

著者について