Varyとは

詳細な図解

Varyを読むときの前提

Varyは、どのリクエストヘッダーごとにキャッシュを分けるかを示すHTTPレスポンスヘッダーです。CORS、言語切替、圧縮、デバイス別表示、CDNキャッシュ制御で使います。

実務では、Vary: Origin、Accept-Encoding、Accept-Language、Authorization、Cookie、CDNのキャッシュキー、プロキシの再利用条件を確認します。

証跡には、対象URL、リクエストヘッダー、Vary値、CDNキャッシュキー、Hit/Miss、ACAO値、レスポンス差分、確認時刻を残します。

キャッシュ混在を防ぐ

Varyが不足すると、Originや言語が違う利用者へ別の利用者向けのレスポンスが返ることがあります。CORSではVary: Originがないと、CDN経由で別Origin向けのACAOが再利用される場合があります。

一方でVaryを広げすぎるとキャッシュ効率が落ちます。分岐に本当に使っているヘッダーだけを指定し、CDN側のキャッシュキーと合わせます。

• レスポンス差分が出るヘッダーを確認する。
• VaryとCDNキャッシュキーを突合する。
• Hit/Missと返却ヘッダーを同時に記録する。

CORSと認証付き応答を見る

OriginごとにACAOを変えるAPIでは、Vary: Originが重要です。認証付きAPIや管理画面では、CookieやAuthorizationの扱いによりキャッシュしてはいけないレスポンスもあります。

ブラウザではCORSエラーに見えても、実際はCDNが古いACAOや別Origin向けの応答を返していることがあります。API、CDN、ブラウザの3点で確認します。

• OriginごとのACAOを比較する。
• 認証付き応答をキャッシュしていないか確認する。
• CDNのヘッダー正規化を確認する。

言語や圧縮の分岐を確認する

Accept-LanguageやAccept-Encodingで応答が変わる場合もVaryが必要です。圧縮済み応答や言語別ページが混ざると、文字化け、表示崩れ、想定外の言語表示につながります。

モバイル/PC、A/Bテスト、地域別出し分けなどをヘッダーで行う場合は、キャッシュキーに含めるか、そもそもキャッシュ対象にしないかを決めます。

• Accept-Encodingと圧縮形式を確認する。
• Accept-Languageの応答差分を見る。
• ヘッダー分岐の所有者を確認する。

変更証跡と引き継ぎ

Vary対応では、対象URL、分岐ヘッダー、Vary値、CDN設定、キャッシュHit/Miss、障害時の再現条件を残します。ブラウザ、CDN、オリジンで見える値が違うためです。

引き継ぎでは、Web基盤担当、API担当、CDN運用担当、関連語としてHTTPヘッダー、CORS、ACAO、CDNを残すと確認しやすくなります。

• 変更前後のレスポンスヘッダーを保存する。
• CDN設定画面のキー条件を記録する。
• 再現に使ったリクエストヘッダーを残す。

関連語

同じ主要カテゴリの用語

Web・APIの学習順

同じ主要カテゴリの用語をまとめて確認できます。現在の用語を起点に、前後の用語へ進むと文脈を保ったまま読み進められます。

InfraEngKit内の関連機能