キャッシュバスティングとは?

キャッシュバスティングは、変更したコンテンツを新しい URL で公開する手法です。通常は、コンテンツハッシュやバージョン識別子をファイル名、パス、クエリ文字列に含めます。HTTP キャッシュは URL をキーに保存済みレスポンスを検索するため、変更された URL の部分を無視するキャッシュがない限り、新しいアドレスへのリクエストに古いアドレスで保存されたコピーが返されることはありません。

キャッシュバスティングの仕組み

HTTP キャッシュは、保存済みレスポンスが新鮮な間はオリジンに問い合わせずに再利用します。そのため、長い max-age を指定して配信したファイルでは、サーバーがそのファイルを置き換える機会となるリクエストが発生しなくなります。CDN のキャッシュは通常パージできますが、ブラウザーがすでに保持しているコピーには届きません。キャッシュバスティングは、この両方の問題を回避します。仕様上、キャッシュキーには少なくともリクエストメソッドと URL が含まれます。一部の CDN では、クエリ文字列をキーから除外するよう設定できます。ある URL のキーが保存されていなければ、対応する保存済みレスポンスもないため、各キャッシュはリクエストをオリジンに向けて転送する必要があります。実際には、バージョン付きファイルに長い max-age を指定し、必要に応じて immutable を併用します。MDN の例では一年、max-age=31536000 を使用しています。一方、それらを参照するドキュメントは no-cache を指定して配信します。これにより、キャッシュは再利用前に再検証する必要があり、ページを新たに読み込むと最新のファイル名を取得できます。MDN は、no-cache が履歴ナビゲーション時の再検証を保証しないため、「戻る」ボタンで以前のページが復元される場合があると説明しています。webpack や Vite などのバンドラーは、ビルド時にハッシュ付きファイル名を生成します。

要点

  1. ファイル名とクエリ文字列のどちらを使うべきでしょうか。app.3f9a1c.js も app.js?v=3f9a1c も URL を変更しますが、クエリ文字列によるバージョン指定が機能するのは、経路上のすべてのキャッシュがクエリ文字列をキャッシュキーに含める場合だけです。Cloudflare のデフォルトのキャッシュレベル「Standard」はこの条件を満たしますが、「Ignore Query String」では、クエリの値にかかわらず、静的ファイルの同じキャッシュコピーを配信します。Amazon CloudFront がクエリ文字列を使ってキャッシュするのは、ディストリビューションでそのように設定した場合だけです。Google Cloud CDN のバックエンドバケットでは、バージョンパラメーターを包含リストに追加する必要があります。また、クエリ文字列によるバージョン指定では、オリジンに一つのファイルを置き、リリースごとに同じ場所で上書きする傾向があります。そのため、前のリリースのページが古い ?v= の URL を要求すると、キャッシュミス後に新しいリリースのファイルを受け取ることになります。Google の Cloud CDN ガイダンスでは、同じ場所で更新するファイルは未完成の状態でキャッシュされる可能性があるため、代わりに一意のファイル名を推奨しています。
  2. 変更のないファイルはリリースをまたいでも同じ URL を維持するのでしょうか。コンテンツハッシュを使う場合、ビルドが同一のバイト列を出力すれば維持されます。すべてのパスにリリース番号やタイムスタンプを付けると、リリースのたびにすべての URL が変わり、変更のないファイルのキャッシュも破棄されます。ソースに変更がないファイルでもハッシュが変わる場合があります。webpack のキャッシュガイドでは、モジュール ID が解決順に従っていたため、無関係のモジュールを追加した後に vendor バンドルの [contenthash] が変わる例を示しています。同ガイドでは、webpack 5 の本番モードはデフォルトで決定的なモジュール ID を使うと説明し、ランタイムも専用のチャンクに分離しています。
  3. デプロイはどの順序で進めるべきでしょうか。まず新しいバージョン付きファイルをアップロードし、それらを参照するドキュメントを最後に公開します。Google の Cloud CDN ガイダンスでも、参照元のファイルより先に依存ファイルをアップロードすることが重要だとしています。前のリリースのファイルも引き続き利用できるようにしてください。デプロイ前に読み込まれたページは古い名前のファイルをリクエストし続けます。webpack と Vite はともに、デプロイで古いファイルを削除すると、チャンクの読み込み失敗やインポートエラーが発生することを説明しています。webpack のガイドでは、次のデプロイ時ではなく、一日程度たってから CDN 上の古いファイルを期限切れにすることを提案しています。また、タブは保持期間を超えて開かれたままになることがあるため、チャンクの読み込みがなお失敗する場合は、ページの再読み込みを最大一回にとどめることを提案しています。
  4. 長い max-age に immutable を加えると何が変わるのでしょうか。レスポンスがまだ新鮮な間は、再読み込み時にファイルを再検証しないようクライアントに伝え、304 を返すだけの条件付きリクエストを省きます。有効期間を延長するものではありません。上書きされないハッシュ付きファイル名のように、レスポンスが新鮮な間、その URL のファイルが変わらない場合にのみ適切です。MDN によると、Chrome はこのディレクティブを実装せず、代わりに再読み込み時のサブリソースの再検証を省略します。

キャッシュバスティングが重要になる場面

スクリプト、スタイルシート、画像など、ブラウザーや CDN に長期間保持させつつ、リリース直後には更新を反映させたいサブリソースには、キャッシュバスティングを使ってください。これらのファイルを参照する HTML ドキュメントなど、同じ URL を維持する必要があるものには適用できません。そのドキュメントは no-cache を付けて配信し、新しくページを読み込むたびにブラウザーが再検証するようにしてください。CDN が再検証せずに自身のキャッシュからドキュメントを配信する設定の場合は、デプロイのたびにそのコピーもパージしてください。パージだけではブラウザーは更新されません。新しいキャッシュキーには、最初はキャッシュがありません。各キャッシュは、ファイルを配信する前に、オリジンまたはオリジンに近いキャッシュから一度取得する必要があります。

Transloadit によるキャッシュバスティングの支援

Transloadit の Smart CDN は、変換後の各バリエーションに固有の URL を割り当てます。Workspace、Template 名、ソースファイルのパス、変換パラメーターは、すべて tlcdn.com アドレスの一部です。そのため、異なるサイズや形式をリクエストすると URL が変わり、別のレンディションが生成されてキャッシュされます。一方、同じ URL でキャッシュヒットした場合は、Template を再実行せずにキャッシュ済みの結果を再利用します。署名付き URL では、レスポンスの実効キャッシュ有効期間は、署名の残りの有効期間を超えません。

ここでリンクしているページには、パージ操作や、同じファイルパスのまま元ファイルを置き換えたときにキャッシュ済みの結果がどうなるかについての説明はありません。置き換え用の元ファイルを新しいパスに保存すると、Smart CDN の URL が変わります。パスを変えない方法に依存する前に、自分の Workspace でそのケースをテストしてください。

Transloadit の配信機能を見る

出典

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す