紀錄工作經驗、相關知識,解決技術相關問題。

網站優化, 網站相關

瀏覽器快取設定:Cache-Control、ETag 與 Service Worker 離線快取完整解析

瀏覽器快取設定:Cache-Control、ETag 與 Service Worker 離線快取完整解析 特色圖片

善用瀏覽器快取設定與 HTTP 快取機制可大幅減少重複請求,本篇解析各類快取標頭運作邏輯與最佳過期時間規劃。若想了解關於網路傳輸協定的基礎細節,可先參閱 淺談 HTTP 請求方法 (HTTP Request Methods):GET、POST、PUT、DELETE 基礎概念與 Fetch 入門。

一、 核心語法速查與規格對照

以內容雜湊命名的靜態資源(例如 main.a1b2c3d4.js)最常見的回應標頭設定如下,透過長效期限搭配驗證標頭,讓用戶端既能享有快取帶來的載入效能,又能在檔名改變時取得新版內容(HTML 進入點的設定見第三節第 5 題):

HTTP/1.1 200 OK
Content-Type: text/javascript; charset=utf-8
Cache-Control: public, max-age=31536000, immutable
ETag: W/"686897696a7c87"
Last-Modified: Wed, 28 Oct 2026 07:00:00 GMT

下表整理了常見的 HTTP 快取控制指令與其在不同情境下的應用特性:

快取標頭與指令作用機制與運作原理適用資源類型注意事項與潛在風險
Cache-Control: max-age指定資源在本地快取保持有效的秒數,期間內不再向伺服器發送請求。圖片、CSS、JavaScript 等靜態主檔若未配合雜湊命名,更新時會導致用戶端無法即時取得新版。
Cache-Control: no-cache強制瀏覽器每次使用快取前,必須先向伺服器發送條件請求驗證資源是否異動。HTML 進入點、動態 API 回應若伺服器端未正確設定 ETag 或 Last-Modified,將退化為每次都完整下載。
Cache-Control: no-store禁止任何快取機制(包含記憶體與磁碟)儲存該回應的任何內容。包含敏感個資、即時交易狀態的頁面會完全失去快取帶來的效能優勢,增加伺服器頻寬負擔。
ETag / Last-Modified透過雜湊值或修改時間進行伺服器端驗證,若未變更則回傳 304 Not Modified。各類動態與靜態資源分散式架構下多台伺服器的檔案修改時間難以同步,Last-Modified 可能不一致;ETag 也需各台伺服器以相同方式產生。

二、 關鍵機制與跨情境細部拆解

1. HTTP 快取運作原理與標頭層級

HTTP 快取的運作核心在於減少不必要的網路傳輸。當瀏覽器首次請求資源時,伺服器會透過回應標頭明確告知該資源的生命週期。較舊的 Expires 標頭使用絕對時間,時間格式不易解析、實作錯誤多,也可能因系統時鐘被調整而出問題,因此 HTTP/1.1 改用 Cache-Control 的 max-age 指定相對秒數;回應同時帶有 max-age 時,快取會忽略 Expires。

若資源內容永遠不變(例如以內容雜湊命名的建置產出物),搭配 immutable 指令可讓瀏覽器在使用者重新整理頁面時,也不必對仍在有效期內的資源發送條件驗證請求。

2. 驗證型快取機制與條件請求

當快取過期或設定為 no-cache 時,瀏覽器會發動條件請求。此時涉及兩種主要的驗證標頭:

  • Last-Modified:以檔案最後修改時間作為驗證依據。
  • ETag:由伺服器產生的識別字串(Entity Tag),產生方式由伺服器決定,常見做法是內容雜湊或版本號;分為強驗證與弱驗證(以 W/ 開頭)。

當瀏覽器再次發起請求時,會夾帶 If-None-Match(對應 ETag)與 If-Modified-Since(對應 Last-Modified)送往伺服器。伺服器比對後若確認未變更,便會回傳 304 Not Modified 狀態碼,回應不帶主體內容。

下圖是資源設定 Cache-Control: no-cache 並帶有上方 ETag 與 Last-Modified 時,同一頁面連續請求兩次的伺服器紀錄:第二次請求同時帶上兩個條件請求標頭並取得 304;設定 max-age=31536000, immutable 的 main.a1b2c3d4.js 第二次請求直接使用快取,伺服器只收到一次。

no-cache 資源第二次請求帶 If-None-Match 與 If-Modified-Since 並取得 304,immutable 資源只請求一次
Chrome 156(headless)、Windows 11、Node.js v22 測試伺服器的請求紀錄

3. 靜態資源長期快取與 Content Hashing 策略

為了兼顧「即時更新」與「長期快取」,前端建置工具(如 Webpack 或 Vite)可在輸出檔名加入依內容產生的雜湊值(Content Hashing),將檔案命名為 main.a1b2c3d4.js 的形式。
當程式碼未修改時,雜湊值不變,瀏覽器可安心設定 max-age=31536000 進行一年期長期快取;一旦程式碼異動,檔案名稱隨之改變,瀏覽器便會自動視為全新資源並重新下載,徹底解決快取無法清除的痛點。

4. Service Worker 與 Workbox 離線快取架構

透過 Service Worker 與 Google Workbox 函式庫,開發者可以在瀏覽器端攔截網路請求,實現更具彈性的離線快取與背景同步機制。Workbox 提供多種預先定義的快取策略,例如 StaleWhileRevalidate(優先回傳快取並同時在背景更新)、CacheFirst(優先讀取快取)與 NetworkFirst(優先請求網路)。這讓漸進式網頁應用程式 (PWA) 即使在網路斷線的極端環境下,也能維持核心頁面的正常瀏覽。


三、 常見問題與排錯(Q&A)

1. Cache-Control 的 no-cache 與 no-store 在實際應用上的根本差異為何?

  • 問題原因:開發者常混淆兩者,誤以為 no-cache 代表不進行任何快取。
  • 解法:no-cache 並非指「不快取」,而是指「不直接使用快取」,瀏覽器仍會將回應存入快取中,但在每次使用前必須先發送驗證請求至伺服器確認是否過期;相對地,no-store 則是嚴格禁止任何快取媒介(包含記憶體與硬碟)儲存該回應的任何片段,適用於含有密碼、憑證或交易明細的敏感頁面。

2. 當 ETag 與 Last-Modified 同時存在時,瀏覽器發動條件請求的優先順序如何判定?

  • 問題原因:伺服器同時回傳多個驗證標頭時,用戶端機制的處理邏輯。
  • 解法:瀏覽器重新驗證時,多數情況會同時送出 If-None-Match(對應 ETag)與 If-Modified-Since(對應 Last-Modified),讓不認得 ETag 的舊中介伺服器也能正確回應。判斷的優先順序在伺服器端:依 RFC 9110,請求帶有 If-None-Match 時,伺服器必須忽略 If-Modified-Since,以 ETag 比對結果為準;只有請求沒有 If-None-Match 時,才會依 If-Modified-Since 判斷。

3. 如何透過 Content Hashing 解決前端靜態資源長期快取的版本更新失效問題?

  • 問題原因:若將 HTML 與所有 JS/CSS 檔案都設定長期快取,發布新版後用戶端會因為檔名相同而持續載入舊版快取。
  • 解法:僅對不包含版本雜湊的進入點檔案(如 index.html)採用 no-cache 或較短的過期時間;而將編譯後的 JS 與 CSS 檔名帶入內容雜湊值。當原始碼改變時,HTML 內參照的檔名隨之改變,強迫瀏覽器抓取新檔案,而未變動的共用模組則繼續享受長期快取優勢。

4. Service Worker 的 Cache API 與傳統 HTTP 快取機制的執行優先權與生命週期衝突該如何排解?

  • 問題原因:當 Service Worker 的 fetch 事件攔截請求並強制讀取 Cache API 時,可能與瀏覽器內建的 HTTP 記憶體/磁碟快取產生衝突或非預期行為。
  • 解法:在設計 Service Worker 邏輯時,應明確釐清分工:對於不可變動的靜態資產交由 Workbox 的預先快取 (Precache) 統一控管;對於 API 動態請求則採用適當的執行策略。同時,應確保伺服器回應標頭設定明確,避免 Service Worker 存入帶有錯誤過期時間的髒資料。

5. 在單頁應用程式 (SPA) 架構中,index.html 應該套用何種 Cache-Control 策略以避免路由更新異常?

  • 問題原因:SPA 架構的所有前端路由皆指向單一的 index.html。若對該檔案設定長效快取,當發布新版本時,使用者重新整理頁面仍會載入舊版 JS 進入點,導致路由對應或模組載入失敗。
  • 解法:主入口的 index.html 設定 Cache-Control: no-cache,讓瀏覽器每次使用前都向伺服器驗證,未變更時只收到 304,有新版時立即取得最新的資產對應清單。常見的 no-cache, no-store, must-revalidate 組合是為了相容忽略 no-store 的舊實作,現在改用 no-cache 即可;no-store 會讓每次造訪都完整下載,也會失去上一頁/下一頁快取(back/forward cache)等瀏覽器優化。

6. Workbox StaleWhileRevalidate 策略會不會把錯誤回應寫進快取?

  • 問題原因:StaleWhileRevalidate 會先回傳舊快取,接著在背景發送請求更新快取。Workbox 的 StaleWhileRevalidate 與 NetworkFirst 預設只快取狀態碼 200 與 0 的回應,504 這類錯誤狀態碼不會寫入;風險在狀態碼 0 的 opaque response(跨來源請求取得的不透明回應):Service Worker 看不到它的實際狀態,無法分辨是正常內容還是跨來源伺服器回傳的錯誤,仍可能被存進快取。CacheFirst 會一直沿用第一次存下的回應,所以預設只快取 200。
  • 解法:背景更新會在之後的成功回應覆蓋暫時的錯誤,多數情況可接受預設值;若跨來源資源不能容忍快取到錯誤,用 workbox-cacheable-response 模組的 CacheableResponsePlugin,把 statuses 只設為 200,排除 opaque response。

7. CDN 節點與瀏覽器雙層快取架構下,如何利用 Vary 標頭確保動態內容與語系正確分流?

  • 問題原因:當 CDN 節點快取了某個 URL 的回應內容後,若不同語系或不同裝置(手機版與電腦版)發出相同 URL 請求,CDN 可能會誤將 A 語系快取直接回傳給 B 語系用戶。
  • 解法:伺服器在回應標頭中宣告 Vary: Accept-Language,告知 CDN 與瀏覽器快取:該資源的回應內容會隨此請求標頭而不同,必須依標頭值分別快取,避免內容錯亂。同一個 URL 的所有回應(包含 304)都應帶相同的 Vary 值。不建議為了手機版與電腦版加入 Vary: User-Agent:User-Agent 的值變化極多,會大幅降低快取的重複使用率,改用功能偵測或響應式設計處理裝置差異較合適。

參考資料與延伸閱讀

發佈留言