Next.js の RSC を CDN でキャッシュするとき、URL だけでは足りない理由
Hina NakahiraCo-founder & CEO at Arkor
同じパスでも、ブラウザーが 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 が再利用してよいのは、次のリクエストにもそのレスポンスが正しい場合だけです。速くても違う形式が届くなら、配信は壊れています。ヒット率の前に、ルートが返す形式と、それを区別する方法を確認します。
著者について

Co-founder & CEO at Arkor