Lighthouseでキャッシュの有効期限を指摘されたときの直し方

​​Lighthouse​Cache-Control,HTTPキャッシュ,nginx,パフォーマンス

Lighthouse 13 で「Use efficient cache lifetimes」(日本語の表示では「効率的なキャッシュ保存期間を使用する」)と指摘されたら、CSS・JavaScript・画像などのレスポンスに、30日以上の Cache-Control: max-age を付ければ消えます。ページを2回目以降に開いたとき(再訪問)の表示を速くしたい場合に、サーバー側で見直す項目です。

期限を長くするなら、ファイル名に中身のハッシュを入れ、HTML には Cache-Control: no-cache を付けます。検証したページでは、この形にすると指摘が消え、再訪問で nginx に届いたリクエストは HTML の1件だけでした。CSS を書き換えたときも、次の訪問で新しい CSS が読み込まれました。

補足

検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、nginx 1.24.0(Ubuntu のパッケージ)です。Lighthouse はコマンドラインから既定の設定(モバイル)で実行し、パフォーマンスのカテゴリーだけを調べました。Chrome は Playwright 1.63.0 に入っている Chrome for Testing 153 を使いました。検証用のページは、HTML に Bootstrap 5.3.3 の CSS(232,803 バイト)、lodash 4.17.21 の JavaScript(73,015 バイト)、PNG の画像(190,811 バイト)を読み込ませたものです。サーバーは同じ VM の中の localhost で動かしました。再訪問は、Playwright から Chrome を開き、タブを閉じて新しいタブで同じ URL を開く方法で試しています。DevTools の Lighthouse パネル、PageSpeed Insights、HTTPS や HTTP/2、CDN を通した配信、Web フォントや動画のファイル、Apache など nginx 以外のサーバーは試していません。

指摘は「Use efficient cache lifetimes」の項目に出る

キャッシュの設定をしていない nginx でページを配り、Lighthouse を実行しました。結果の JSON から、この項目(cache-insight)のところを小さなスクリプト(summarize.mjs)で抜き出すと、次のようになりました。

console
$ npx lighthouse http://localhost:8080/index.html --only-categories=performance --output=json --output=html --output-path=./out/none --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
$ node summarize.mjs out/none.report.json
lighthouseVersion: 13.6.0  formFactor: mobile  locale: en-US
performance score: 88
cache-insight: score=0 scoreDisplayMode=metricSavings displayValue="Est savings of 486 KiB" title="Use efficient cache lifetimes"
  metricSavings={"FCP":1200,"LCP":2700}
  item: /style.css cacheLifetimeMs=0 totalBytes=233054 wastedBytes=233054
  item: /hero.png cacheLifetimeMs=0 totalBytes=191063 wastedBytes=191063
  item: /app.js cacheLifetimeMs=0 totalBytes=73279 wastedBytes=73279
  weight in performance: 0
audits with "cache" in id: ["bf-cache","cache-insight"]

HTML のレポートでは、赤い三角のアイコンが付いた項目として出ます。開くと、ファイルごとに「Cache TTL」(キャッシュの有効期限)と「Transfer Size」(転送量)の表が並びます。設定がないファイルの Cache TTL は「None」です。

LighthouseのレポートでUse efficient cache lifetimesの項目を開いた画面。Est savings of 486 KiBと出ていて、style.css、hero.png、app.jsの3行のCache TTLがすべてNoneになっている
キャッシュの設定をしていないページのレポート

Lighthouse 12 までは「Serve static assets with an efficient cache policy」(uses-long-cache-ttl)という名前の項目でした。Lighthouse 13.0.0 の変更履歴には、パフォーマンスのインサイト(insights)に置き換えられた項目を取り除いたと書かれています。13.6.0 のコードでも、cache-insight は uses-long-cache-ttl の代わりになる項目として登録されていました。検索で古い名前の解説が見つかったときは、Lighthouse 12 までの項目のことです。

この項目は、13.6.0 の設定でパフォーマンスの点数への重みが 0 で、レポートにも「Unscored」と出ます。直しても、点数は直接には上がりません。検証でのパフォーマンスの点数は、どの設定でも 88〜90 の間でした。

対象はCSS・JavaScript・画像などで、HTMLは入らない

この項目の公式の解説によると、調べる対象は、フォント・画像・メディア・スクリプト・スタイルシートのうち、ステータスコードが 200、203、206 のものです。上の結果でも、表に出たのは CSS、PNG、JavaScript の3つで、Cache-Control を何も付けていない HTML は出ませんでした。

30日以上にすると消える

nginx の expires で期限を変えながら、Lighthouse を実行しました。nginx の解説にあるとおり、expires 7d; と書くと、Expires と Cache-Control: max-age=604800 の2つのヘッダーが付きます。

nginx
location ~* \.(css|js|png)$ {
    expires 7d;
}

結果は次のとおりです。

CSS・JavaScript・画像の設定 付いたヘッダー Lighthouse の表示
設定なし (Last-Modified と ETag だけ) Est savings of 486 KiB
expires 7d; Cache-Control: max-age=604800 Est savings of 49 KiB
expires 29d; Cache-Control: max-age=2505600 Est savings of 46 KiB
expires 30d; Cache-Control: max-age=2592000 指摘なし

7日にしても指摘は残り、表の Cache TTL が「7d」になりました。

LighthouseのレポートでUse efficient cache lifetimesの項目を開いた画面。Est savings of 49 KiBと出ていて、3行のCache TTLがすべて7dになっている
expires 7d にしたページのレポート

29日でも残り、30日で消えました。公式の解説にも、キャッシュできるファイルの期限は最低30日(2,592,000 秒)にするよう書かれています。

「Est savings」の数字は、期限が長いほど小さくなります。13.6.0 の判定のコード(依存しているパッケージ @paulirish/trace_engine 0.0.67 の Cache.js)では、期限から「再訪問のときにまだキャッシュが使える割合」を見積もり、使えない割合の分だけを転送量から数えています。7日なら使える割合が 90% とされ、style.css の転送量 233,125 バイトのうち 23,312 バイトが数えられていました。30日以上の期限は、見積もりをせずに対象から外します。

no-cacheやmust-revalidateでも指摘は消える

公式の解説では、レスポンスヘッダーでキャッシュの対象から外すと明示したもの(no-cache、must-revalidate、no-store など)は対象にしないとされています。13.6.0 のコードでは、private も同じ扱いでした。CSS・JavaScript・画像に Cache-Control: no-cache を付けたときも、max-age=600, must-revalidate(10分)を付けたときも、指摘は出ませんでした。

指摘が消えても、再訪問が速くなるとは限りません。HTML には no-cache を付けたうえで、ページを開いてタブを閉じ、新しいタブで同じ URL を開きました。2回目にサーバー(nginx)へ届いたリクエストは次のとおりです。

CSS・JavaScript・画像の設定 2回目に nginx へ届いたリクエスト
expires 7d; HTML の1件(304)
Cache-Control: no-cache HTML・CSS・JavaScript・画像の4件(すべて 304)
Cache-Control: max-age=600, must-revalidate HTML の1件(304)
ハッシュ入りのファイル名と max-age=31536000, immutable HTML の1件(304)

no-cache を付けると、Chrome は CSS・JavaScript・画像のたびに、変わっていないかをサーバーに問い合わせました。中身が変わっていなければ 304(Not Modified)が返り、ファイルの本体は送られません。それでも、ファイルの数だけサーバーとのやり取りが起きます。MDN の HTTP キャッシュの解説にも、no-cache は保存を止めるのではなく、使う前にサーバーへ確かめさせる指定だと書かれています。

設定がなくても、ブラウザはしばらくキャッシュを使う

Cache-Control を何も付けていないファイルを、Lighthouse は Cache TTL を「None」(0秒)として数えます。一方で、Chrome はこうしたファイルもキャッシュに残して使いました。

ファイルの更新時刻(Last-Modified)を100秒前にして試すと、すぐに2回目を開いたときは、HTML を含めて nginx に1件もリクエストが届きませんでした。15秒待ってから開くと、4件とも 304 で問い合わせが届きました。

MDN の解説では、これをヒューリスティックキャッシュと呼んでいます。期限を書かないレスポンスも、条件が合えば保存して使われ、その長さは実装しだいで、仕様では更新されてからの時間の 10% 程度が勧められています。いつまで使われるかを決めておくため、MDN はすべてのレスポンスに Cache-Control を明示するよう勧めています。

期限を長くするなら、ファイル名にハッシュを入れる

ファイル名を変えずに期限だけを延ばすと、ファイルを書き換えても、キャッシュが残っている間は古いファイルが使われます。ファイル名を style.css のまま変えず、expires 30d; を付けたページで、1回目を開いた後に CSS の末尾を書き換え、2回目を開きました。HTML は no-cache なので問い合わせが届きましたが、style.css は nginx に問い合わせずにディスクのキャッシュから読み込まれ、書き換える前の CSS が当たったままでした。

console
--- port 8082(ファイル名は同じ、CSS は expires 30d、HTML は no-cache)
  1回目: CSS の --v=(なし)
  $ node change-css.mjs site
  site/style.css を書き換えた
  2回目: CSS の --v=(なし)
  chrome: /index.html status=200 fromDiskCache=false
  chrome: /style.css status=200 fromDiskCache=true
  chrome: /hero.png status=200 fromDiskCache=true
  chrome: /app.js status=200 fromDiskCache=true
  nginx に届いたリクエスト(2回目): 1 件
  nginx: 8082 304 "GET /index.html HTTP/1.1" inm="\x226af928f0-23c\x22" ims="Sun, 15 Nov 2026 03:37:20 GMT"

(書き換えでは、CSS の末尾に body{--v:"2"} を足しています。--v は、ページで当たっている CSS がどちらかを見分けるための値です。)

MDN の解説では、中身が変わるファイルは、変わるたびに URL を変える方法(キャッシュバスティング)を勧めています。ファイル名に中身のハッシュを入れる(style.3c8f27e6.css のように)と、中身が変われば名前も変わり、名前が変わらない限り中身は同じです。こうしたファイルには、期限を1年にして immutable を付けられます。MDN の Cache-Control の解説によると、immutable は、有効期限が切れるまでレスポンスが更新されないことを示す指定です。

ハッシュを入れたページでも、同じように CSS を書き換えました。新しいハッシュの名前(style.7a98e5d3.css)で CSS を作り、HTML の参照を書き換えています。2回目に開くと、HTML が 200 で新しく届き、そこに書かれた新しい名前の CSS が読み込まれました。変えていない JavaScript と画像は、ディスクのキャッシュから読み込まれています。

console
--- port 8084(ファイル名にハッシュ、CSS は max-age=31536000, immutable、HTML は no-cache)
  1回目: CSS の --v=(なし)
  $ node change-css.mjs site-hashed
  site-hashed/style.7a98e5d3.css を作り、index.html の参照を style.3c8f27e6.css から書き換えた
  2回目: CSS の --v="2"
  chrome: /index.html status=200 fromDiskCache=false
  chrome: /style.7a98e5d3.css status=200 fromDiskCache=false
  chrome: /hero.7babdb96.png status=200 fromDiskCache=true
  chrome: /app.a9705dfc.js status=200 fromDiskCache=true
  nginx に届いたリクエスト(2回目): 2 件
  nginx: 8084 200 "GET /index.html HTTP/1.1" inm="\x226af928f8-257\x22" ims="Sun, 15 Nov 2026 03:37:28 GMT"
  nginx: 8084 200 "GET /style.7a98e5d3.css HTTP/1.1" inm="-" ims="-"

このとき使った nginx の設定は、次のとおりです。ハッシュは8文字の16進数にしています。

nginx
server {
    listen 8084;
    root /path/to/site-hashed;

    # ファイル名にハッシュが入った CSS・JavaScript・画像は1年
    location ~* "\.[0-9a-f]{8}\.(css|js|png)$" {
        add_header Cache-Control "public, max-age=31536000, immutable";
    }

    # HTML などそのほかのファイルは、毎回サーバーに確かめさせる
    location / {
        add_header Cache-Control "no-cache";
    }
}

(検証で使った設定を、改行してコメントを足しています。root のパスは例示用の値に置き換えています。)

正規表現に {8} のような波かっこを含むときは、正規表現全体を引用符で囲みます。囲まずに書いたところ、nginx の設定の確認(nginx -t)で unknown directive のエラーになりました。

この設定で Lighthouse を実行すると、「Use efficient cache lifetimes」は合格の表示になり、指摘は出ませんでした。curl でレスポンスヘッダーを見ると、CSS には Cache-Control: public, max-age=31536000, immutable、HTML には Cache-Control: no-cache が付いています。

console
$ curl -s -o /dev/null -D - http://localhost:8084/style.3c8f27e6.css
HTTP/1.1 200 OK
Content-Type: text/css
Last-Modified: Sun, 15 Nov 2026 03:37:28 GMT
ETag: "6af928f8-38d63"
Cache-Control: public, max-age=31536000, immutable
$ curl -s -o /dev/null -D - http://localhost:8084/index.html
HTTP/1.1 200 OK
Content-Type: text/html
Last-Modified: Sun, 15 Nov 2026 03:37:28 GMT
ETag: "6af928f8-257"
Cache-Control: no-cache

(Date などのヘッダーの行は省いています。)

ファイル名を変えられないファイルに expires 30d; を付けると Lighthouse の指摘は消えますが、上で試したとおり、書き換えてもキャッシュが残っている間は古いファイルが使われます。

​Posted by 86