Web・ネットワーク
PR

HTTPキャッシュの仕組み|Cache-Control・ETag・304を実験で確認

HTTPキャッシュの仕組み|Cache-Control・ETag・304を実験で確認
hr
記事内に商品プロモーションを含む場合があります

CSS を直してサーバーに上げたのに、画面が変わらない。開発者ツールを開くと、ステータスが「304」になっている。これが HTTP のキャッシュの動きです。うまく使えばページが速くなり、間違えると「更新が反映されない」「他人の情報が表示される」といった問題になります。

この記事では、キャッシュを指示する Cache-Control ヘッダーと、変更の有無を確かめる ETag・Last-Modified、そして 304 Not Modified の仕組みを、HTTP の仕様書(RFC 9111・RFC 9110)と MDN の説明を確かめながら解説します。後半では、Python で作った小さなサーバーを自分の PC だけで動かし、curl とブラウザーで実際の動きを確かめます。

実行環境は Windows 11・Python 3.12.6・Windows 標準の curl.exe 8.21.0・Microsoft Edge 155(ヘッドレス)です(2026 年 10 月に確認)。

HTTP のキャッシュとは

ブラウザーは、サーバーから受け取ったレスポンス(HTML・CSS・JavaScript・画像など)を保存しておき、同じ URL が必要になったときに再利用できます。これが HTTP のキャッシュです。再利用できれば、通信の待ち時間がなくなり、サーバーの負担も減ります。

キャッシュには、置かれる場所によって 2 種類あります。MDN の説明をもとにまとめると次のとおりです。

種類場所使う人
プライベートキャッシュ(private cache)ブラウザーの中その利用者だけ
共有キャッシュ(shared cache)CDN やプロキシなど、ブラウザーとサーバーの間複数の利用者で共有

共有キャッシュは、ある人へのレスポンスを保存して、別の人にも返します。この違いが、後で説明する「ログイン後のページの注意」に関係します。

保存されたレスポンスには「新鮮(fresh)」と「古い(stale)」の 2 つの状態があります。新鮮なあいだは、サーバーに問い合わせずにそのまま使えます。古くなったら、サーバーに「まだ使ってよいか」を確認します。この確認を再検証(revalidation)と呼び、変わっていなければサーバーは本文を送らずに 304 Not Modified だけを返します。後の実験で実際に起きた流れを図にすると、次のようになります。

HTTP キャッシュの流れ。1 回目はブラウザーが GET /max.js を送り、サーバーが 200 OK と本文、Cache-Control: max-age=10 と ETag: 5119d35c930126a0 を返し、ブラウザーが保存する。10 秒以内は新鮮なので、保存した本文を使い、サーバーにはリクエストを送らない。10 秒を過ぎて古くなると、If-None-Match にその ETag を付けた条件付きリクエストを送り、サーバーは本文なしの 304 Not Modified を返す。ブラウザーは保存した本文を使い続ける。
図 1:キャッシュの基本の流れ(max-age と ETag)

Cache-Control の主な指定

サーバーは、レスポンスに Cache-Control ヘッダーを付けて、キャッシュしてよいか・いつまで新鮮かを伝えます。指定(ディレクティブ)はカンマで区切って並べられます(例:Cache-Control: private, max-age=600)。よく使うものは次のとおりです。

指定意味定義
max-age=秒数受け取ってからその秒数が過ぎるまで新鮮RFC 9111 5.2.2.1
no-cache保存してよいが、使う前に毎回サーバーに確認するRFC 9111 5.2.2.4
no-storeどのキャッシュにも保存しないRFC 9111 5.2.2.5
private共有キャッシュには保存しない(ブラウザーには保存してよい)RFC 9111 5.2.2.7
public本来は保存できない場合(Authorization 付きのリクエストなど)でも共有キャッシュに保存してよいRFC 9111 5.2.2.9
immutable新鮮なあいだは内容が変わらない(再検証しなくてよい)RFC 8246(MDN で解説)

max-age:何秒間そのまま使ってよいか

max-age=600 なら、レスポンスの「年齢(age)」が 600 秒を超えるまでは新鮮です。RFC 9111 は「年齢が指定の秒数を超えたら古いとみなす」と定めています。1 日なら 86400、1 年なら 31536000 です。

古い仕組みに Expires: Thu, 22 Oct 2026 21:00:00 GMT のように期限の日時を書く Expires ヘッダーもあります。RFC 9111 5.3 では、max-age があるときは Expires を無視しなければならないとしています。新しく設定するなら max-age を使えば十分です。

no-cache は「キャッシュしない」ではない

名前から誤解されやすいのが no-cache です。RFC 9111 では、no-cache 付きのレスポンスはサーバーに確認(再検証)しないかぎり再利用してはいけないという意味です。保存すること自体は禁止していません。MDN も「no-cache は『キャッシュしない』という意味ではない」と明記しています。

つまり no-cache は「毎回確認する」です。確認の結果、変わっていなければ 304 が返り、保存していた本文が使われるので、本文の転送は省けます。「常に最新を表示したいが、変わっていないときは無駄に送りたくない」HTML などに向いています。

no-store:そもそも保存しない

「保存させたくない」なら no-store です。RFC 9111 は、キャッシュはリクエストとレスポンスのどの部分も保存してはいけないと定めています。毎回サーバーから本文が丸ごと送られます。

ただし、MDN は no-store をむやみに付けることは勧めていません。ブラウザーの「戻る・進む」を速くする仕組み(back/forward cache)などの利点も失うためで、個人向けの内容は「no-cache, private」を優先するよう説明しています。

private と public:共有キャッシュに置いてよいか

private は「この利用者専用なので、共有キャッシュには保存しないで」という指定で、ブラウザーには保存できます。public は、本来なら保存できない場合でも保存してよいという指定です。RFC 9111 3.5 では、共有キャッシュは Authorization ヘッダー付きのリクエストへのレスポンスを、原則として再利用してはいけません。public を付けるとこの制限が外れます。MDN も、public が必要なのは Authorization 付きのレスポンスを保存したいときだけだとしています。

Cache-Control を付けないとどうなるか

キャッシュの指定がないレスポンスでも、条件を満たせば保存・再利用されることがあります。これをヒューリスティックキャッシュ(経験則によるキャッシュ)と呼びます。RFC 9111 4.2.2 では、Last-Modified(最終更新日時)から経過した時間の一部を新鮮な期間とする方法が挙げられ、その割合は「10% が典型的」とされています。たとえば 10 日前に更新されたファイルなら、約 1 日はサーバーに確認せずに使われる可能性があります。

MDN も「基本的にすべてのレスポンスに Cache-Control を明示すべき」としています。

ETag と If-None-Match

再検証では、「手元にある版」と「サーバーの今の版」が同じかを比べます。そのための目印をバリデーター(validator)と呼び、代表が ETag です。

ETag(エンティティタグ)は、レスポンスの版を表す文字列で、ETag: "5119d35c930126a0" のように二重引用符で囲みます。中身のハッシュ値や更新番号など、作り方はサーバーの自由です。RFC 9110 8.8.3 では、厳密には同じとは言えない(意味が同じなら同じ値にする)タグには W/ を付けて W/"xyzzy" のように「弱い ETag」にすると定めています。

ブラウザーは、保存していた ETag をリクエストの If-None-Match ヘッダーに入れて送ります。「この ETag のどれにも一致しなければ(変わっていれば)本文を送って」という意味です。RFC 9110 13.1.2 では、サーバーは弱い比較(W/ の有無を無視して比べる)で照合し、GET・HEAD で一致したら 304 を返すと定めています。

Last-Modified と If-Modified-Since

もう 1 つのバリデーターが Last-Modified(最終更新日時)です。サーバーが Last-Modified: Thu, 22 Oct 2026 19:47:38 GMT を返すと、ブラウザーは再検証のときに If-Modified-Since にその日時を入れて送ります。サーバーは、その日時より後に変更がなければ 304 を返します。

日時は秒単位なので、1 秒以内に 2 回更新されると区別できません。また、ファイルをコピーし直しただけで日時が変わることもあります。ETag のほうが正確に判断できるため、両方あるときは ETag が優先されます。RFC 9110 13.1.3 では、If-None-Match があるときは If-Modified-Since を無視しなければならないと定めています。

304 Not Modified とは

304 Not Modified は、エラーではありません。RFC 9110 15.4.5 では「条件付きの GET か HEAD を受け取り、条件が成り立たなかった(変わっていなかった)ので、本来なら 200 になるところを 304 にした」という意味です。ブラウザーは保存していた本文を使います。

  • 304 には本文を入れられない(ヘッダーの終わりでレスポンスが終わる)
  • 200 なら付けるはずだった Cache-Control・ETag・Expires・Vary・Date・Content-Location は、304 にも付けなければならない
  • キャッシュは、保存しているレスポンスのヘッダーを 304 で届いたヘッダーで更新し(RFC 9111 4.3.4)、古くなっていたレスポンスを再び新鮮なものとして使う(MDN)

200・304 以外のステータスコードの意味は、当サイトの「HTTPステータスコード検索」で番号から調べられます。

実際に試す:自作サーバーで 304 を返す

Python の標準ライブラリだけで、キャッシュのヘッダーを返すサーバーを作ります。自分の PC(127.0.0.1)の中だけで動き、外部には公開されません。作業用のフォルダーを作り、次の cache_server.py を保存します。

import hashlib
import time
from email.utils import formatdate, parsedate_to_datetime
from http.server import BaseHTTPRequestHandler, HTTPServer

# パスごとの Cache-Control と本文
PAGES = {
    "/max.js": ("max-age=10", b"console.log('max');\n"),
    "/nocache.js": ("no-cache", b"console.log('no-cache');\n"),
    "/nostore.js": ("no-store", b"console.log('no-store');\n"),
}
INDEX = (b'<!DOCTYPE html>\n<meta charset="utf-8">\n<title>cache test</title>\n'
         b'<script src="/max.js"></script>\n<script src="/nocache.js"></script>\n'
         b'<script src="/nostore.js"></script>\n<p>ok</p>\n')
LAST_MODIFIED = time.time() - 3600  # 1 時間前に更新されたことにする


class Handler(BaseHTTPRequestHandler):
    protocol_version = "HTTP/1.1"  # 既定の HTTP/1.0 だと Edge が ETag を使わなかったため

    def do_GET(self):
        inm = self.headers.get("If-None-Match")
        ims = self.headers.get("If-Modified-Since")
        if self.path == "/":
            print("/", flush=True)
            self.send_response(200)
            self.send_header("Content-Type", "text/html; charset=utf-8")
            self.send_header("Cache-Control", "no-store")
            self.send_header("Content-Length", str(len(INDEX)))
            self.end_headers()
            self.wfile.write(INDEX)
            return
        if self.path not in PAGES:
            self.send_error(404)
            return
        cache_control, body = PAGES[self.path]
        etag = '"' + hashlib.sha256(body).hexdigest()[:16] + '"'
        last_modified = formatdate(LAST_MODIFIED, usegmt=True)

        not_modified = False
        if inm is not None:  # If-None-Match があれば If-Modified-Since は見ない
            not_modified = etag in [t.strip() for t in inm.split(",")]
        elif ims is not None:
            try:
                not_modified = parsedate_to_datetime(ims).timestamp() >= int(LAST_MODIFIED)
            except (TypeError, ValueError):
                pass

        print(self.path, "If-None-Match:", inm, "If-Modified-Since:", ims,
              "->", 304 if not_modified else 200, flush=True)
        self.send_response(304 if not_modified else 200)
        self.send_header("Cache-Control", cache_control)
        self.send_header("ETag", etag)
        if not_modified:
            self.end_headers()
            return
        self.send_header("Last-Modified", last_modified)
        self.send_header("Content-Type", "text/javascript; charset=utf-8")
        self.send_header("Content-Length", str(len(body)))
        self.end_headers()
        self.wfile.write(body)

    def log_message(self, format, *args):
        pass  # 標準のアクセスログは出さない


HTTPServer(("127.0.0.1", 8093), Handler).serve_forever()

/max.js は max-age=10、/nocache.js は no-cache、/nostore.js は no-store を返します。ETag は本文の SHA-256 ハッシュの先頭 16 文字です。If-None-Match が ETag と一致するか、(If-None-Match がなく)If-Modified-Since が更新日時以降なら、本文なしの 304 を返します。リクエストごとに、届いた条件のヘッダーと返したステータスを表示します。

作業用フォルダーで PowerShell を開き、サーバーを起動します(終了は Ctrl+C)。

py cache_server.py

curl で 1 回目のレスポンスを見る

もう 1 つ PowerShell を開き、-i(ヘッダーも表示)を付けて取得します。

curl.exe -i http://127.0.0.1:8093/max.js
HTTP/1.1 200 OK
Server: BaseHTTP/0.6 Python/3.12.6
Date: Thu, 22 Oct 2026 20:48:03 GMT
Cache-Control: max-age=10
ETag: "5119d35c930126a0"
Last-Modified: Thu, 22 Oct 2026 19:47:38 GMT
Content-Type: text/javascript; charset=utf-8
Content-Length: 20

console.log('max');

Cache-Control・ETag・Last-Modified が付いています。日時は実行した時刻によって変わりますが、ETag は本文から計算するので同じ値になります。

If-None-Match を付けて 304 を受け取る

ブラウザーの再検証をまねて、さきほどの ETag を If-None-Match に入れて送ります。PowerShell 5.1 では、外部のコマンドに渡す文字列の中の " が消えてしまうため、\" と書きます(理由は「よくある間違い」で説明します)。

curl.exe -i -H 'If-None-Match: \"5119d35c930126a0\"' http://127.0.0.1:8093/max.js
HTTP/1.1 304 Not Modified
Server: BaseHTTP/0.6 Python/3.12.6
Date: Thu, 22 Oct 2026 20:48:03 GMT
Cache-Control: max-age=10
ETag: "5119d35c930126a0"

304 が返り、本文はありません。Cache-Control と ETag は 304 にも付いています。サーバー側には次のように表示されました。

/max.js If-None-Match: "5119d35c930126a0" If-Modified-Since: None -> 304

同じように If-Modified-Since に 1 回目の Last-Modified の日時を入れて送っても、304 が返りました。一方、If-None-Match に違う ETag("0000")と、一致する If-Modified-Since の両方を付けて送ると、結果は 200 でした。If-None-Match が優先されるので、ETag が違えば「変わった」と判断されます。

curl の –etag-save と –etag-compare

curl には、ETag をファイルに保存して次回の If-None-Match に使うオプションがあります。引用符の問題も起きないので便利です。まず ETag を etag.txt に保存しながら取得します(-w でステータスコードだけを表示)。

curl.exe -s --etag-save etag.txt -o max.js -w "%{http_code}\n" http://127.0.0.1:8093/max.js

表示は 200 で、etag.txt には "5119d35c930126a0" が保存されました。次に、保存した ETag を使って取得します。

curl.exe -s --etag-compare etag.txt -o max.js -w "%{http_code}\n" http://127.0.0.1:8093/max.js

表示は 304 でした。サーバーには If-None-Match: "5119d35c930126a0" が届いていました。304 のときは本文がないので、max.js は 1 回目の内容のまま残っています。curl の基本は「curlコマンドの使い方」で解説しています。

ブラウザー(Edge)で確かめる

curl はキャッシュを持たないので、「期限内ならサーバーに行かない」動きはブラウザーで確かめます。サーバーの / は、max.js・nocache.js・nostore.js の 3 つを読み込むページです(ページ自体は no-store)。ヘッドレスの Edge で、同じプロフィール(キャッシュの保存先)を使ってこのページを 3 回開き、サーバーの表示を見ました。2 回目は 1 回目の直後、3 回目は 12 秒待ってから開いています。

--- 1 回目
/
/max.js If-None-Match: None If-Modified-Since: None -> 200
/nocache.js If-None-Match: None If-Modified-Since: None -> 200
/nostore.js If-None-Match: None If-Modified-Since: None -> 200
--- 2 回目(直後)
/
/nostore.js If-None-Match: None If-Modified-Since: None -> 200
/nocache.js If-None-Match: "1a30205702ec75ab" If-Modified-Since: Thu, 22 Oct 2026 19:47:38 GMT -> 304
--- 3 回目(12 秒後)
/
/max.js If-None-Match: "5119d35c930126a0" If-Modified-Since: Thu, 22 Oct 2026 19:47:38 GMT -> 304
/nostore.js If-None-Match: None If-Modified-Since: None -> 200
/nocache.js If-None-Match: "1a30205702ec75ab" If-Modified-Since: Thu, 22 Oct 2026 19:47:38 GMT -> 304

(「— 1 回目」などの区切りは説明のために加えたものです。)ここから次のことが分かります。

  • max-age=10 の max.js は、10 秒以内の 2 回目にはサーバーにリクエストが来ていない。期限が切れた 3 回目は、If-None-Match と If-Modified-Since の両方を付けた再検証になり、304 だった
  • no-cache の nocache.js は、直後でも毎回確認している。保存はされているので、確認の結果は 304
  • no-store の nostore.js は、ETag を受け取っているのに If-None-Match を送っていない。保存していないので、比べる版がない

なお、最初は protocol_version を指定せず、Python の既定の HTTP/1.0 で試しました。このときの Edge は 2 回目以降に If-Modified-Since だけを送り、If-None-Match は送りませんでした。HTTP/1.1 で応答するようにしたところ、上のように両方を送るようになりました。自作のサーバーで ETag を試すときは、HTTP/1.1 で応答しているかも確認しましょう。

また、MDN によると、ブラウザーの再読み込みボタン(F5)では、期限内でもリクエストに Cache-Control: max-age=0 と条件のヘッダーが付き、確認が行われます。今回の実験は再読み込みではなく、ページを新しく開き直す形で行いました。

ファイル名にハッシュを付けて長期キャッシュする

CSS や JavaScript、画像は、なるべく長くキャッシュさせたほうが速くなります。しかし max-age を 1 年にすると、ファイルを直しても利用者のブラウザーには 1 年間古い版が残ってしまいます。この矛盾を解決するのが、MDN が「キャッシュバスティング(cache busting)」として紹介している方法です。

  1. CSS・JS などのファイル名に、内容のハッシュ値や版番号を入れる(例:app.3f9a2c.js)
  2. そのファイルには Cache-Control: max-age=31536000, immutable を付け、1 年間確認なしで使わせる
  3. ファイルを直したら、上書きせずに新しい名前(app.8b71d0.js)で公開し、HTML の参照を書き換える
  4. HTML には Cache-Control: no-cache を付け、毎回確認させる。新しい HTML が新しいファイル名を指すので、更新がすぐに反映される
ハッシュ付きファイル名による長期キャッシュ。index.html には Cache-Control: no-cache を付けて毎回サーバーに確認し、変わらなければ 304。index.html が読み込む app.3f9a2c.js には max-age=31536000, immutable を付けて 1 年間確認なしで使う。app.js を直して公開すると、新しい index.html はハッシュが変わった別の URL の app.8b71d0.js を読み込むので、古い app.3f9a2c.js のキャッシュは使われず、新しいファイルを取得する。
図 2:HTML は毎回確認し、ハッシュ付きのファイルは長くキャッシュする

immutable は RFC 9111 ではなく RFC 8246 で定められた指定で、MDN は「新鮮なあいだは更新されない」ことを示し、ハッシュ付きのファイルに付けると再検証を省けると説明しています。ファイル名にハッシュを付ける作業は、ビルドツールに任せるのが一般的です。たとえば Vite の公式ドキュメントでも、ビルドで作られる JS・CSS・画像などを「hashed assets(ハッシュ付きのアセット)」と呼んでいます。

MDN は、内容が変わらないと言い切れない場合は 1 か月(max-age=2592000)程度にしておく案も示しています。同じファイル名のまま中身を変えるファイルに、長い max-age を付けないことが大切です。

ログイン後のページ・個人情報の注意

キャッシュの設定ミスで特に危ないのは、ある利用者向けのページが共有キャッシュに保存され、別の利用者に返されることです。マイページの名前やメールアドレス、注文履歴が他人に見えてしまいます。MDN も、個人向けの内容に private を付け忘れると、共有キャッシュに保存されて複数の利用者に再利用され、個人情報の漏えいにつながると警告しています。

ページの種類設定の例考え方
ハッシュ付きの CSS・JS・画像max-age=31536000, immutable内容が変わらないので長く使わせる
誰が見ても同じ HTMLno-cache毎回確認し、変わらなければ 304
ログイン後のページ(個人向け)no-cache, private共有キャッシュに置かせない(MDN の推奨)
個人情報・決済など、端末にも残したくないページno-storeどこにも保存させない

注意したい点がいくつかあります。

  • Cookie があるだけでは private にならない。MDN のとおり、Cookie だけではレスポンスは private にならない。ログイン後のページには自分で private(または no-store)を付ける
  • no-cache だけでは共有キャッシュへの保存は防げない。no-cache は「使う前に確認する」なので、個人向けのページには private も付ける
  • no-store は秘密を守る万能の仕組みではない。RFC 9111 5.2.2.5 も、no-store はプライバシーを確実に守るための十分な仕組みではないと注意している。通信の暗号化(HTTPS)やアクセス制御は別に必要

ログイン状態を保つ仕組みは「Cookieとセッションの仕組みとは?」、通信の暗号化は「HTTPとHTTPSの違いとは?」で解説しています。

よくある間違い

no-cache を「保存しない」だと思っている

実験のとおり、no-cache のファイルは保存され、2 回目からは 304 で使い回されました。保存させたくないなら no-store です。逆に「毎回最新にしたいだけ」なら、no-store より no-cache のほうが転送量を減らせます。

PowerShell で If-None-Match を送ったのに 304 にならない

PowerShell 5.1 で curl.exe -i -H 'If-None-Match: "5119d35c930126a0"' http://127.0.0.1:8093/max.js と書くと、結果は 200 でした。サーバーに届いた値は 5119d35c930126a0 で、二重引用符が消えていたため ETag と一致しなかったのです。PowerShell 5.1 が外部のコマンドに引数を渡すとき、中の " を取り除いてしまうことが原因です。\" と書くか、curl の --etag-compare を使うと正しく送れます(Git Bash なら 'If-None-Match: "…"' のままで送れます)。

よくある質問

max-age=0 と no-cache は同じですか?

似ていますが、定義は別です。max-age=0 は「0 秒で古くなる」という期限の指定です。RFC 9111 4.2.4 では、古いレスポンスでも、サーバーとつながっていないときや max-stale などで明示的に許されたときは、確認なしで使われることがあります。no-cache は「確認なしに再利用してはいけない」という指示なので、毎回確実に確認させたいなら no-cache を使います。

まとめ

HTTP のキャッシュは、Cache-Control で「いつまで確認なしで使えるか」を決め、期限が切れたら ETag や Last-Modified で確認し、変わっていなければ 304 で本文を省く仕組みです。no-cache は毎回確認、no-store は保存しない、と区別しましょう。長くキャッシュさせるファイルにはハッシュ付きのファイル名を、ログイン後のページには private か no-store を使います。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました