システム・プロトコル図鑑 · 基礎から応用へ

HTTPキャッシュ:鮮度・再検証・共有範囲

max-age、no-cache、no-store、Varyを具体的な応答で区別します。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 保存と再利用は別の判断
  2. 鮮度が切れた応答を検証する
  3. 誰と何を共有できるか
  4. 変更を反映するときの確認
  5. 60秒の鮮度と304応答を追う
  6. Ageを含む鮮度の計算を確かめる
  7. ログイン済みの応答を共有するときの境界
  8. 更新と削除の伝わり方を検査する
  9. 演習:二言語と二利用者の要求を照合する
  10. この記事をロゲイアに質問する理解を確かめる

保存と再利用は別の判断

HTTPキャッシュは応答を保存し、条件を満たす後続の要求に再利用します。保存できるかと、サーバーへ確認せず再利用できるかは別の判断です。Cache-Controlの指示を、保存禁止と再検証の要求に分けて読みます。

no-storeは保存しないよう指示します。no-cacheは名前に反して保存自体を必ず禁止するものではなく、再利用前の検証を要求します。これらを同じ意味で扱うと、期待する負荷削減や情報保護になりません。

鮮度が切れた応答を検証する

例えばmax-age=60なら、キャッシュは応答の経過時間などから鮮度を判定します。60秒たった瞬間に元データが必ず変更されたという意味ではありません。期限は、確認せず使ってよい時間の約束です。

ETagを保存している場合、If-None-Matchを付けて再検証できます。変更がなければ304応答を受け、保持していた本文を使えます。304は本文の再送ではないため、キャッシュ側に再利用する表現があることが前提です。

誰と何を共有できるか

ブラウザ専用のキャッシュと、CDNなど複数利用者が共有するキャッシュでは、情報が渡る範囲が異なります。個人向けの応答を共有可能にすると、別の利用者へ誤った内容を返す危険があります。privateなどの指示と認証条件を確認します。

Accept-Encodingなどで応答が変わるなら、Varyはキャッシュが区別すべき要求ヘッダーを伝えます。ただURLだけが同じという理由で、言語や認証条件の違う応答を同一視してはいけません。

変更を反映するときの確認

更新が見えないときは、応答ヘッダーと実際の経路を確認します。ブラウザ、サービスワーカー、CDN、オリジン内部のキャッシュが重なることもあり、一つを消しても別の保存先が残り得ます。AgeやCache-Control、ETagを対応付けます。

動的な情報すべてをキャッシュ禁止にすると、不要な再計算や通信も増えます。許容できる古さ、利用者間の共有可否、更新時の無効化方法を、情報の用途ごとに設計します。

60秒の鮮度と304応答を追う

説明用に、転送時間と時計の誤差を無視し、時刻0秒に生成・保存された応答へCache-Control: max-age=60とETag: "v7"が付いたとします。同じキャッシュキーへの時刻50秒の要求では、他の再利用条件も満たすなら、まだfreshな応答を使えます。時刻70秒では通常の鮮度期間を過ぎています。If-None-Match: "v7"で検証し、304 Not Modifiedが返れば、キャッシュは応答のメタデータを更新し、保存済み本文を使えます。304は本文が空だからページ内容も空になる、という意味ではありません。実際のage計算にはDate、Age、通信時間なども関係します。

この例で同じURLが英語と日本語を返すなら、URLだけで一つの本文を選ぶと誤配信し得ます。Vary: Accept-Languageが指定された場合は、そのフィールドの値も照合に使います。認証された個人向けデータでは、共有キャッシュへ保存してよいかも別途判断します。no-cacheは保存を一切禁じる指示ではなく、再利用前の検証を要求します。一方、no-storeは保存そのものを制限します。鮮度、検証、照合条件、保存可否を一つの「キャッシュ有効」フラグで扱わず、応答と要求の指示を合わせて判断します。

時刻・応答通常の判断
0秒応答をmax-age=60、ETag=v7で保存
50秒他の条件を満たせばfreshとして再利用
70秒stale。If-None-Matchで検証できる
304応答必要なメタデータを更新し保存済み本文を使う

Ageを含む鮮度の計算を確かめる

説明用に、共有キャッシュから受け取った応答がmax-age=60、Age=40を示し、追加の転送時間を無視できるとします。この時点で新たに60秒使えるのではなく、残る鮮度はおおむね20秒です。さらに25秒保持すれば、通常の鮮度期間は過ぎています。実際にはDate、受信時刻、転送時間などから現在のageを計算するため、Ageという一つの数値だけを常に引けば十分というわけでもありません。時計のずれや複数段のキャッシュも考慮します。freshは元データが今も同じという観測結果ではなく、指定された条件で検証せず再利用できる状態を表します。

ログイン済みの応答を共有するときの境界

利用者ごとに異なるダッシュボードを、URLが同じだからという理由で共有キャッシュへ入れるのは危険です。保存可否に加えて、認証付き要求の規則、privateなどの指示、アプリやCDNが使うキーを確認します。Varyは指定された要求ヘッダーの照合条件ですが、それだけで任意の認可処理を代替できるわけではありません。Cookieがある応答は絶対にキャッシュされない、と製品の設定を確認せず仮定することも避けます。学習では個人情報を使わず、二人の仮想利用者で値が混ざらないかを試すと、同じURLと同じ公開範囲が別の問題だと分かります。

更新と削除の伝わり方を検査する

無効化の試験では、古い本文を保存した状態を作ってから更新し、その後の要求でどのキャッシュが応答したかを調べます。新しいURLで配信する静的資産と、同じURLの内容を変えるAPIでは、更新の伝え方が異なります。アプリの再読み込み、ブラウザのキャッシュ、CDNの無効化、サービスワーカーの更新は同一の操作ではありません。404やリダイレクトなど本文以外の応答も、条件によって保存対象になります。更新が見えないという症状に対し、すべてのキャッシュを無効にする前に、再現に必要な要求と応答のヘッダーを記録し、保存、鮮度、検証、照合のどこで期待と違ったかを確かめます。

演習:二言語と二利用者の要求を照合する

同じ/productsというURLが日本語と英語の商品一覧を返すとします。本文は全利用者で共通で、応答にCache-Control: public, max-age=60とVary: Accept-Languageがあります。時刻0秒に利用者Aの日本語要求を保存しました。時刻10秒に利用者Bが英語を要求したとき、URLと鮮度だけを比べて日本語を返してよいでしょうか。解答は不可です。保存済み応答に指定されたVaryの照合条件を満たさないため、英語の表現を取得する必要があります。

時刻20秒にBが日本語を要求するなら、認証や他の制限がなく、要求と保存済み応答の再利用条件を満たすこの例では、A向けに保存した共通の日本語表現を使えます。利用者が違うという理由だけで共通コンテンツの共有が常に禁止されるわけではありません。反対に、同じ言語だからといって個人向けの情報まで共有してよいわけでもありません。照合と保存可否を別に答えてください。

次に/my-ordersへ変更し、Aの注文番号が本文に入り、応答はCache-Control: private, max-age=60とします。共有キャッシュはこの応答を保存できません。言語を区別するVaryを追加しても、privateによる共有範囲は広がりません。利用者ごとの専用キャッシュへ保存する場合も、そのキャッシュ内で正しい利用者と表現へ対応させる必要があります。CookieやETagがあるという事実だけで、認可や利用者の境界が実現されたとは判断しません。

最後の判断課題は、商品一覧の英語版だけを更新したとき、保存済み日本語版のETagで英語版も検証できるか、です。模範解答は、英語の選択表現とその検証子へ対応させて条件付き要求を作る、です。検証子がどの表現を指すかを保ちます。304の受信を、別言語や別利用者の本文へ自由に置き換えられる許可とは扱いません。実装を試す際は無害な二つの本文を使い、要求ヘッダー、応答の指示、選ばれた本文を一行ずつ対応付けます。

要求共有キャッシュの判断
B・英語 /products日本語の保存済み応答はVary不一致
B・日本語 /products他の条件も満たせば共通応答を再利用
A /my-orders、private共有キャッシュへ保存しない
B /my-ordersAの注文本文を流用しない

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 10

学習コースから次を選ぶ