Cache-Control ヘッダーとは何ですか?
Cache-Control は HTTP リクエストまたはレスポンスのヘッダーで、ディレクティブによってキャッシュの保存、鮮度、再検証、再利用を制御します。ブラウザーと共有の中継キャッシュには、それぞれ異なるディレクティブを適用できます。
Cache-Control ヘッダーの仕組み
Cache-Control は、HTTP リクエストまたはレスポンスに付けるカンマ区切りのディレクティブでポリシーを伝えます。鮮度に関するディレクティブは、オリジンに問い合わせずに再利用できる期間を定めます。保存、検証、適用範囲に関するディレクティブは、プライベートキャッシュと共有キャッシュが保持または配信できる内容を制限します。仕様に準拠するキャッシュはレスポンスのディレクティブに従う必要がありますが、リクエストのディレクティブは助言にとどまります。CDN は、クライアントがオリジンへの問い合わせを強制できるディレクティブを無視する場合があります。たとえば Google Cloud CDN は、リクエスト内の no-cache と max-age を無視します。このヘッダーは経路上のすべてのキャッシュに一括して作用し、特定のキャッシュだけを指定できません。そのため、RFC 9213 では、同じディレクティブを使用する別のレスポンスヘッダー
CDN-Cache-Control を定義しています。対応する CDN キャッシュは、これを Cache-Control の代わりに使用します。
要点
no-cacheはレスポンスの保存を許可しますが、再利用のたびにオリジンでの検証が成功することを要求します。no-storeは、プライベートか共有かを問わず、すべてのキャッシュにレスポンスを一切保存しないよう指示します。RFC 9111 はさらに、no-storeがプライバシーを確保するための信頼できる、または十分な仕組みではないとしています。つまり、これはキャッシュへの指示であり、アクセス制御の代わりにはなりません。max-ageはすべてのキャッシュの鮮度保持期間を設定します。s-maxageは CDN などの共有キャッシュでその値を上書きし、ブラウザーでは無視されます。内容が変わるたびに URL も変わるファイルについて、MDN は長いmax-age(例では一年)とimmutableを組み合わせるパターンを示しています。後者は、レスポンスが新鮮な間は更新されないことを示します。s-maxageにはproxy-revalidateの意味も含まれます。レスポンスが古くなると、共有キャッシュは再利用前に再検証する必要があります。Cloudflare では、Free、Pro、Business プランでデフォルトの Origin Cache Control が有効な場合、s-maxageが付いた古いレスポンスを配信しません。Google Cloud CDN のドキュメントにも同じ動作が記載されているため、これらの環境では、併用してもstale-while-revalidateは効果を持ちません。Cloudflare がドキュメントで示す回避策は、max-ageとstale-while-revalidateを組み合わせ、エッジ TTL ルールを別途設定する方法です。privateは共有キャッシュへの保存を禁止しますが、ブラウザー自身のキャッシュへの保存は許可するため、キャッシュの無効化とは異なります。個人向けにカスタマイズしたレスポンスには、明示的に設定する必要があります。HTTP 自体が共有キャッシュへのレスポンスの保存を制限するのは、リクエストにAuthorizationヘッダーが含まれる場合だけです。その場合でも、public、s-maxage、またはmust-revalidateがあれば、その制限は解除されます。Cookieリクエストヘッダーでセッションを送信しても、このようなルールは適用されません。また、RFC 9111 は、Set-Cookieレスポンスヘッダーがキャッシュを妨げないとしています。Google Cloud CDN は、Set-Cookieを持つレスポンスをキャッシュしません。Cloudflare も、デフォルトのキャッシュレベルでは Origin Cache Control が有効な間はキャッシュしませんが、無効な場合はSet-Cookieヘッダーを取り除いてレスポンスをキャッシュすることがあります。いずれもプロバイダー固有の動作であり、HTTP のルールではありません。Cache-Controlがないレスポンスも、キャッシュされることがあります。RFC 9111 は、明示的な有効期限がなく、ヒューリスティックにキャッシュ可能なレスポンスに対して、キャッシュがヒューリスティックな有効期間を設定することを認めています。推奨される上限は、Last-Modifiedからの経過時間の一定割合です。オリジンが有効期間を送信しない場合、CDN は独自のデフォルト値を適用します。エラーにも同じルールが適用され、鮮度が明示された最終レスポンスは保存されることがあります。そのため、成功レスポンス用の長いmax-ageを付けて送信した 5xx は、下流のキャッシュに保存され、再び配信される可能性があります。ただし、CDN が保存するステータスコードはプロバイダーによって異なります。キャッシュしてはならないレスポンスには必ずno-storeを付け、エラーレスポンスには成功時の有効期間を付けないでください。CDN は、ヘッダーでは無効にできない独自の設定に基づいてエラーをキャッシュすることもあります。Amazon CloudFront は、500、502、503、504 のレスポンスでno-store、no-cache、privateを無視し、Error Caching Minimum TTL の期間キャッシュします。この値はステータスコードごとに設定され、デフォルトは 10 秒です。キャッシュビヘイビアで CachingDisabled マネージドキャッシュポリシーを使用する場合、これらのエラーはキャッシュされません。- オリジンのヘッダーが、エッジで常に最優先されるとは限りません。Amazon CloudFront は、キャッシュポリシーの最小 TTL が 0 より大きい場合、オリジンが
no-cache、no-store、またはprivateを送信していても、その最小 TTL を使用します。Cloudflare の Edge Cache TTL ルールは、s-maxageと再検証ディレクティブを上書きします。Google Cloud CDN のFORCE_CACHE_ALLモードは、オリジンのディレクティブにかかわらず成功レスポンスをキャッシュします。ディレクティブによって共有キャッシュへの保存を防げると判断する前に、CDN の TTL と上書き設定を確認してください。
Cache-Control ヘッダーが重要になる場面
レスポンスが公開か非公開か、不変か頻繁に更新されるかに応じて Cache-Control を設定してください。矛盾するディレクティブや過度に許容的なディレクティブは、非公開データの露出や古いメディアの保持につながるおそれがあります。
Cache-Control ヘッダーに関する Transloadit の機能
Transloadit が Smart CDN 経由で変換済みファイルを配信する際は、Robot /file/serve が結果の Cache-Control ヘッダーを設定します。ブラウザーでの有効期間は max-age に、共有キャッシュでの有効期間は
s-maxage に個別に設定されます。この Robot の cache_duration パラメーターは両方のディレクティブを同じ値に設定し、headers パラメーターは独自のヘッダー値をデフォルト値にマージして上書きします。署名付き Smart CDN URL では、実際のキャッシュ有効期間は署名の残りの有効期間によっても制限されます。
現在のデフォルトの有効期間は Robot のページに記載されています。
出典
- RFC 9111、セクション 5.2:Cache-Control
- RFC 9213:対象を指定した HTTP キャッシュ制御(CDN-Cache-Control)
- RFC 5861:stale-while-revalidate と stale-if-error
- MDN:Cache-Control ヘッダーリファレンス
- Cloudflare:Origin Cache Control(エッジでのディレクティブの動作)
- Amazon CloudFront:コンテンツのキャッシュ保持期間の管理(TTL 設定とオリジンのヘッダー)
- Amazon CloudFront:CloudFront によるエラーのキャッシュ保持期間の制御(Error Caching Minimum TTL)
- Google Cloud CDN:キャッシュの概要(キャッシュモードとディレクティブ一覧)