no-cacheにヘッダ名を書くのは誤りか Cache-Controlの引数付き指定
Cache-Control: no-cache は「保存してよいが、使う前に毎回オリジンに確認する」という指定である。ところが、no-cache="Set-Cookie" のようにヘッダ名を引数に付けた書き方もある。これを見て「no-cache は値を取らないので書き間違い」と判断するツールや人がいるが、これは RFC 9111 に定められた正しい書式で、意味も引数なしとは違う。
この記事では、ハシトシステムの Cache-Control 解析ツール の判定と、RFC 9111 の規定、Node.js の HTTP クライアント undici のキャッシュの実際の動きを並べて、引数付きの no-cache と private がどう扱われるかを確かめる。検証環境は Windows 11、Node.js v24.11.1、undici 7.30.2 である。
RFC 9111 の規定
HTTP キャッシュの仕様 RFC 9111 では、no-cache(5.2.2.4)と private(5.2.2.7)の2つが、引数なしの形と、ヘッダ名の並びを引数に取る形(qualified form)の両方を持つ。
| 書き方 | 意味 |
|---|---|
no-cache |
応答をオリジンに確認せずに再利用してはいけない |
no-cache="Set-Cookie" |
挙げたヘッダは確認なしで再利用する応答に含めてはいけない。応答の残りはキャッシュしてよい |
private |
共有キャッシュ(CDN・プロキシ)は応答を保存してはいけない |
private="X-User" |
挙げたヘッダだけが1人の利用者向け。共有キャッシュは応答の残りを保存してよい |
つまり no-cache="Set-Cookie", max-age=600 は「本体は600秒そのまま使ってよいが、Set-Cookie は付けたまま他の要求に使い回すな」という指定になる。引数なしの no-cache とは、再検証が要るかどうかがまるで違う。
ただし RFC 9111 は、どちらの節にも「引数付きの形は、多くのキャッシュで引数なしと同じに扱われることが多い」という注記を付けている。引数付きの形を正しく実装していないキャッシュでは、より安全側(引数なし)に倒れる、ということである。
ほかに、この記事に関係する規定が3つある。
- 1.2.2: 秒数(delta-seconds)が扱える最大の整数を超えたら、2147483648(2^31)か、扱える最大の正の整数とみなす
- 4.2.1: 同じディレクティブが複数あるときは、最初のものを使うか、応答を古いものとして扱う
- 5.2: 送る側は
max-age=5のようにトークン形で書く。受ける側はmax-age="5"のような引用符付きの形も受け付けるのが望ましい
ツールの判定
Cache-Control 解析 は、値を貼るとディレクティブの意味、ブラウザと共有キャッシュそれぞれの新鮮期間、矛盾を表示するツールである。2026-11-16 に本番の HTML から判定の関数を取り出し、Node.js で動かすと次のようになった。
| 入力 | ツールの判定 | RFC 9111 から見た評価 |
|---|---|---|
no-cache="X-User", max-age=600 |
「値を取らないディレクティブに値が付いています」をエラーとして表示。状態は「毎回オリジンへ確認」 | 書式は正しい。本体は600秒再利用してよい |
private="X-User", max-age=600 |
共有キャッシュは「保存されない(private)」 | 共有キャッシュは X-User を除いて保存してよい |
max-age=3600, max-age=60 |
最初の3600秒を採用し、重複をエラー表示 | 最初を使うのは規定どおり |
max-age=99999999999 |
新鮮期間 99999999999 秒 | 2147483648 秒とみなす |
max-age="3600" |
3600秒 | 受け付けるのが望ましいので規定どおり |
状態の表示(毎回確認・保存しない)は、注記にある「引数なしと同じに扱うキャッシュが多い」という実情に合わせれば安全側の答えである。直すべきなのは、正しい書式の no-cache="..." を「エラー」と表示している点で、これは修正対象として記録した。
private の引数付きの形はツールの内部で受け付けているが、共有キャッシュの判定では引数なしと区別していない。どちらの扱いをするキャッシュもあるので、表示は「引数なしとして扱うキャッシュでは保存されない」のように条件付きにするのが正確である。
undici で実際に動かす
undici 7 には HTTP キャッシュの interceptor があり、type: 'shared'(共有キャッシュ)と type: 'private'(個人用キャッシュ)を選べる。ソースの lib/util/cache.js の parseCacheControlHeader は、no-cache と private の引数をヘッダ名の配列として読み、lib/handler/cache-handler.js は保存時にその配列のヘッダを応答から取り除く。
ローカルにサーバーを立て、X-User: alice を付けた応答を同じ URL に2回取りに行った。origin はサーバーに届いた回数、2nd は2回目に返った本体、x-user は2回目の応答に付いていたヘッダである。
| キャッシュ | Cache-Control | origin | 2nd | x-user |
|---|---|---|---|---|
| 共有 | no-cache="X-User", max-age=600 |
1 | body#1 | (none) |
| 共有 | private="X-User", max-age=600 |
1 | body#2 | (none) |
| 共有 | no-cache, max-age=600 |
2 | body#4 | alice |
| 共有 | private, max-age=600 |
2 | body#6 | alice |
| 個人用 | no-cache="X-User", max-age=600 |
1 | body#7 | (none) |
| 個人用 | private="X-User", max-age=600 |
1 | body#8 | (none) |
| 個人用 | no-cache, max-age=600 |
2 | body#10 | alice |
| 個人用 | private, max-age=600 |
1 | body#11 | alice |
引数付きの形では、サーバーには1回しか届かず、2回目はキャッシュから本体が返った。そのとき X-User は外されている。引数なしの no-cache は毎回サーバーに届き(この応答には ETag も Last-Modified も無いので、確認ではなく取り直しになる)、引数なしの private は共有キャッシュでは保存されず、個人用キャッシュでは保存された。RFC 9111 の表のとおりの動きである。
個人用キャッシュでも private="X-User" で X-User が外れている。RFC 上、private の制限は共有キャッシュに対するものなので個人用キャッシュは X-User を残してよいが、undici は種類を問わず外している。外して困ることは少ないので、安全側の実装と言える。
もう1つ、ヘッダを X-User ではなく Set-Cookie にして同じことをすると、共有キャッシュでは4つとも origin が2になった。cache-handler.js の canCacheResponse が、共有キャッシュでは Set-Cookie を含む応答を保存しないようにしているためである。no-cache="Set-Cookie" は仕様の典型例だが、undici の共有キャッシュではそもそも保存の対象にならない。
undici 7.30.2 の解析結果は、ほかの規定についても次のとおりだった。
max-age=99999999999は 2147483647 に打ち止め(RFC は 2147483648 か扱える最大値)max-age="3600"は 3600 として受け付けるmax-age=60, max-age=3600とmax-age=3600, max-age=60は、どちらも小さいほうの 60 を採用(RFC の「最初を使う」とは違うが、短いほうを取るので新鮮期間を延ばす方向には外れない)max-age=1hは無視される
なお、private="" のように引数の中身が空の形は、undici の CVE-2026-13697 で「共有キャッシュに入れてよい」と読まれていた形である。7.30.2 では引数なしの private として扱われる。
実際に試す
前提: Node.js(確認は v24.11.1)。1つ目は undici(確認は 7.30.2)を使う。
まず、undici のキャッシュで引数付きの形を確かめるスクリプトである。空のディレクトリで npm install undici@7 してから実行する。
1 | |
1 | |
X-User を Set-Cookie に置き換えると、共有キャッシュの4行がすべて origin=2 になる。
次に、RFC 9111 の規定どおりに Cache-Control を読む最小の実装である。外部パッケージは使わない。
1 | |
1 | |
no-cache="Set-Cookie, X-User" のように引用符の中にカンマがあっても、1つのディレクティブとして読めている。private="" は中身が空なので、安全側の引数なしとして扱っている。
送る側としての使い分け
- 応答本体は共通で、Set-Cookie など一部のヘッダだけが利用者ごとに違うなら、引数付きの形で意図は書ける。ただし注記のとおり引数なしとして扱うキャッシュが多く、undici の共有キャッシュは Set-Cookie 付きの応答を保存しない。キャッシュさせたい応答では、利用者ごとのヘッダをそもそも付けないほうが確実である。
- 共有キャッシュに置いてはいけない応答は、引数付きに頼らず引数なしの
privateかno-storeを使う。 - 秒数は引用符を付けず、整数で書く。
1hのような単位は無視される。 - 同じディレクティブを2回書かない。RFC 9111 は最初を使うか古いものとして扱うとしているが、undici は小さいほうを採用するなど、実装によって結果が変わる。
まとめ
no-cacheとprivateは、ヘッダ名を引数に取る形が RFC 9111 で定められている。no-cache="Set-Cookie"は書き間違いではない。- 引数付きの形は「そのヘッダだけを制限し、本体は再利用してよい」という意味で、引数なしとは再検証や保存の有無が変わる。
- undici 7.30.2 のキャッシュは引数付きの形を実装しており、本体を再利用して指定したヘッダだけを外した。ただし共有キャッシュでは Set-Cookie 付きの応答をそもそも保存しない。
- RFC 自身が「引数なしと同じに扱うキャッシュが多い」と書いているので、送る側は引数付きの形に頼らない設計にしておくのが安全である。
結果は 2026-11-16 時点の上記の環境とツールの実装で得たものである。
参考
- RFC 9111「HTTP Caching」1.2.2 Delta Seconds、4.2.1 Calculating Freshness Lifetime、5.2 Cache-Control、5.2.2.4 no-cache、5.2.2.7 private
- undici 7.30.2 のソース
lib/util/cache.js(parseCacheControlHeader)とlib/handler/cache-handler.js(canCacheResponse・stripNecessaryHeaders)、および上記スクリプトでの実測 - ハシトシステム Cache-Control 解析ツールの本番 HTML(2026-11-16 取得)
このバージョンはその範囲に入るのか
依存の話でいちばん間違えやすいのは ^1.2.3 や ~1.2.3 がどこまでを許すかです(^0.2.3 のようにメジャーが 0 のときは規則が変わります)。範囲とバージョンを貼ると、下限・上限に展開したうえで一致・不一致とその理由を表示するsemver 範囲判定ツールを置いています。ブラウザの中だけで動き、入力はどこにも送信しません。