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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// cc-qualified.mjs(Node.js v24.11.1 + undici 7.30.2 で確認)
// 使い方: npm install undici@7 && node cc-qualified.mjs
// 引数付きの no-cache / private を、undici のキャッシュ(共有・個人)がどう扱うかを確かめる
import http from 'node:http';
import { Agent, interceptors, request } from 'undici';

const CASES = [
'no-cache="X-User", max-age=600',
'private="X-User", max-age=600',
'no-cache, max-age=600',
'private, max-age=600',
];

let hits = 0;
const server = http.createServer((req, res) => {
hits++;
const i = Number(new URL(req.url, 'http://x').searchParams.get('c'));
res.setHeader('Cache-Control', CASES[i]);
res.setHeader('X-User', 'alice'); // 利用者ごとに変わる想定のヘッダ
res.end('body#' + hits);
}).listen(0);
await new Promise((r) => server.once('listening', r));
const base = `http://127.0.0.1:${server.address().port}`;

for (const type of ['shared', 'private']) {
for (let i = 0; i < CASES.length; i++) {
const agent = new Agent().compose(interceptors.cache({ type }));
const before = hits;
const r1 = await request(`${base}/?c=${i}`, { dispatcher: agent }); await r1.body.text();
const r2 = await request(`${base}/?c=${i}`, { dispatcher: agent }); const b2 = await r2.body.text();
console.log(`${type.padEnd(7)} ${CASES[i].padEnd(32)} origin=${hits - before} ` +
`2nd=${b2.padEnd(8)} x-user=${r2.headers['x-user'] ?? '(none)'}`);
await agent.close();
}
}
server.close();
1
2
3
4
5
6
7
8
9
$ node cc-qualified.mjs
shared no-cache="X-User", max-age=600 origin=1 2nd=body#1 x-user=(none)
shared private="X-User", max-age=600 origin=1 2nd=body#2 x-user=(none)
shared no-cache, max-age=600 origin=2 2nd=body#4 x-user=alice
shared private, max-age=600 origin=2 2nd=body#6 x-user=alice
private no-cache="X-User", max-age=600 origin=1 2nd=body#7 x-user=(none)
private private="X-User", max-age=600 origin=1 2nd=body#8 x-user=(none)
private no-cache, max-age=600 origin=2 2nd=body#10 x-user=alice
private private, max-age=600 origin=1 2nd=body#11 x-user=alice

X-User を Set-Cookie に置き換えると、共有キャッシュの4行がすべて origin=2 になる。

次に、RFC 9111 の規定どおりに Cache-Control を読む最小の実装である。外部パッケージは使わない。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// cc-parse.mjs(Node.js v24.11.1 で確認・外部パッケージ不要)
// 使い方: node cc-parse.mjs
// RFC 9111 に沿って Cache-Control を読む最小実装。引数付き no-cache / private、
// 引用符付きの数値、2^31 での打ち止め、重複したディレクティブを扱う
const DELTA = new Set(['max-age', 's-maxage', 'stale-while-revalidate', 'stale-if-error', 'min-fresh', 'max-stale']);
const FIELDS = new Set(['no-cache', 'private']); // 引数にフィールド名の並びを取れる
const TOKEN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;

// 引用符の中のカンマでは区切らない
function split(value) {
const out = []; let buf = '', q = false;
for (const ch of value) {
if (ch === '"') q = !q;
if (ch === ',' && !q) { out.push(buf); buf = ''; } else buf += ch;
}
out.push(buf);
return out.map((s) => s.trim()).filter(Boolean);
}

export function parseCacheControl(value) {
const d = {}, notes = [];
for (const item of split(String(value))) {
const eq = item.indexOf('=');
const name = (eq < 0 ? item : item.slice(0, eq)).trim().toLowerCase();
let arg = eq < 0 ? null : item.slice(eq + 1).trim();
if (arg && arg.length >= 2 && arg.startsWith('"') && arg.endsWith('"')) arg = arg.slice(1, -1); // 受け手は引用符付きも受け付ける(5.2)
if (name in d) { notes.push(`${name} が重複: 最初の値を使う(4.2.1)`); continue; }
if (DELTA.has(name)) {
if (arg === null || !/^\d+$/.test(arg)) { notes.push(`${item}: 秒数でないので無視`); continue; }
d[name] = Math.min(Number(arg), 2 ** 31); // 1.2.2: 大きすぎる値は 2147483648 とみなす
} else if (FIELDS.has(name) && arg !== null) {
const fields = arg.split(',').map((s) => s.trim().toLowerCase()).filter(Boolean);
d[name] = fields.length && fields.every((f) => TOKEN.test(f)) ? fields : true; // 読めなければ引数なしと同じに倒す
} else {
d[name] = arg ?? true;
}
}
return { d, notes };
}

// 共有キャッシュから見た新鮮期間と、再利用時に外すヘッダ
export function sharedView({ d }) {
if (d['no-store'] || d.private === true) return '保存しない';
const life = d['s-maxage'] ?? d['max-age'];
if (d['no-cache'] === true) return `保存はするが毎回再検証(新鮮期間 ${life ?? '-'} 秒は使わない)`;
const strip = [...(Array.isArray(d['no-cache']) ? d['no-cache'] : []), ...(Array.isArray(d.private) ? d.private : [])];
return (life == null ? '新鮮期間の指定なし' : `新鮮期間 ${life} 秒`) + (strip.length ? `・再利用時に外す: ${strip.join(', ')}` : '');
}

for (const v of [
'no-cache="Set-Cookie", max-age=600',
'no-cache="Set-Cookie, X-User", s-maxage=300',
'private="X-User", max-age=600',
'private="", max-age=600',
'no-cache, max-age=600',
'max-age="3600"',
'max-age=99999999999',
'max-age=3600, max-age=60',
'max-age=1h',
]) {
const r = parseCacheControl(v);
console.log(v.padEnd(44), '=>', JSON.stringify(r.d), '|', sharedView(r), r.notes.length ? '| ' + r.notes.join(' / ') : '');
}
1
2
3
4
5
6
7
8
9
10
$ node cc-parse.mjs
no-cache="Set-Cookie", max-age=600 => {"no-cache":["set-cookie"],"max-age":600} | 新鮮期間 600 秒・再利用時に外す: set-cookie
no-cache="Set-Cookie, X-User", s-maxage=300 => {"no-cache":["set-cookie","x-user"],"s-maxage":300} | 新鮮期間 300 秒・再利用時に外す: set-cookie, x-user
private="X-User", max-age=600 => {"private":["x-user"],"max-age":600} | 新鮮期間 600 秒・再利用時に外す: x-user
private="", max-age=600 => {"private":true,"max-age":600} | 保存しない
no-cache, max-age=600 => {"no-cache":true,"max-age":600} | 保存はするが毎回再検証(新鮮期間 600 秒は使わない)
max-age="3600" => {"max-age":3600} | 新鮮期間 3600 秒
max-age=99999999999 => {"max-age":2147483648} | 新鮮期間 2147483648 秒
max-age=3600, max-age=60 => {"max-age":3600} | 新鮮期間 3600 秒 | max-age が重複: 最初の値を使う(4.2.1)
max-age=1h => {} | 新鮮期間の指定なし | max-age=1h: 秒数でないので無視

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 取得)

no-cacheにヘッダ名を書くのは誤りか Cache-Controlの引数付き指定
https://blog.hashito.biz/2026/11/16/cache-control-no-cache-private-field-names-qualified-rfc9111-undici/
著者
hashito
作成日
2026年11月16日
著作権

このバージョンはその範囲に入るのか

依存の話でいちばん間違えやすいのは ^1.2.3 や ~1.2.3 がどこまでを許すかです(^0.2.3 のようにメジャーが 0 のときは規則が変わります)。範囲とバージョンを貼ると、下限・上限に展開したうえで一致・不一致とその理由を表示するsemver 範囲判定ツールを置いています。ブラウザの中だけで動き、入力はどこにも送信しません。