鮮度と猶予を二段階で表す
Stale-while-revalidateは、鮮度が切れた応答を短い猶予の間だけ返し、その間に再検証する仕組みです。HTTPではmax-ageが通常の鮮度期間、stale-while-revalidateがその後の追加猶予を表します。古い応答を返す許可と、正本の内容が変わっていないという証明は別です。更新確認が終わる前の読者には古い内容が見えるため、価格や権限などで許容できるかを先に判断します。
600秒と30秒の例
max-age=600, stale-while-revalidate=30なら、生成後の年齢が600秒を超えても、追加の30秒の範囲では古い値を返しながら再検証できます。610秒時点の要求は待ち時間を隠せますが、再検証が完了しないまま631秒へ進めば、この拡張による猶予は終わります。30秒ごとに無条件で猶予が延長されるわけではありません。実際のAgeや検証後のメタデータで次の鮮度を判断します。
再検証を共有し、別の指示も確認する
多数の要求が同じ失効へ集中すると、バックグラウンド処理も重複しがちです。キーごとに再検証を共有するなど、正本への集中を抑えます。HTTPではmust-revalidateや共有キャッシュ向けの制約など、他の指示との組み合わせを仕様に沿って扱う必要があります。独自のアプリ用SWRライブラリとHTTPキャッシュは同名でも完全に同じ意味ではありません。認証状態の異なる利用者へ同じ応答を共有しないことも重要です。
障害時の猶予とは区別する
SWRの目的は再検証の待ち時間を隠すことで、障害が続く限り古い値を返してよいという意味ではありません。エラー時の古い応答には別のstale-if-errorなどの条件があります。更新間隔、猶予内の再検証成功率、最古の配信年齢を記録すると、速さだけでは見えない鮮度の劣化を検出できます。変更が強く求められる緊急告知には、明示的な無効化や別の配信経路が必要になる場合があります。
再検証を行うアクセスがなければ、バックグラウンド処理そのものが始まらない実装もあります。設定した猶予だけで事前更新が必ず走ると思わず、最初の再訪者がどの経路を通るかを確認します。更新に失敗した後の再試行も、同時に増やしすぎないよう制限します。