善用瀏覽器快取設定與 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 第二次請求直接使用快取,伺服器只收到一次。

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的值變化極多,會大幅降低快取的重複使用率,改用功能偵測或響應式設計處理裝置差異較合適。
參考資料與延伸閱讀
- MDN Web Docs – HTTP caching
- MDN Web Docs – Cache-Control
- MDN Web Docs – ETag
- web.dev – Prevent unnecessary network requests with the HTTP Cache
- Workbox Documentation – Chrome for Developers
- Workbox – workbox-cacheable-response
- webpack – Caching
- RFC 9110 – HTTP Semantics
- RFC 9111 – HTTP Caching
- 淺談 HTTP 請求方法 (HTTP Request Methods):GET、POST、PUT、DELETE 基礎概念與 Fetch 入門
- Core Web Vitals LCP 最大內容繪製:Sub-parts 四階段拆解、fetchpriority 與首屏載入調校
發佈留言