細節決定成敗。瀏覽器快取本來是為了提升載入效率,但也帶來一個惱人的副作用:伺服器端已經改了 JS 或 CSS,使用者那邊卻還在跑舊版本,怎麼重新整理都沒用。
<script type="text/javascript" src="/js/test.js?+Math.random()"></script>
瀏覽器把完整的 URL(含 query string)作為快取的鍵,網址每次都不同,快取自然永遠命中不了。
缺點很致命:快取完全失效。每次載入都重新下載整份檔案,白白浪費頻寬,也拖慢首屏。
設定一個全域變數當版本號,每次發版手動加一:
<script type="text/javascript" src="/js/test.js?v=<%=v%>"></script>
這樣的行為是:版本沒變時快取正常生效,版本一改所有資源網址跟著改變,快取自動失效。兼顧了效能與更新即時性,是實務上最常採用的做法。
缺點是靜態 HTML 頁面無法用(因為沒有後端模板變數可插入),不過這類頁面通常本來也不 extensive 需要版本控制。
大型專案通常會在建置流程中自動處理這件事,做法是以檔案內容計算雜湊(例如取檔案大小與修改時間,或直接算 MD5),把雜湊嵌進檔名或 query:
app.a1b2c3d4.js style.e5f6g7h8.css
Webpack、Vite、Rollup 這類打包工具預設就會做這件事([contenthash]),同時還能順手完成壓縮與合併。建置時自動全局替換版本號,完全不需要人工維護。
有了指紋化檔名之後,就可以大膽對靜態資源設定長期快取:
· 帶 hash 的檔案:Cache-Control: public, max-age=31536000, immutable
· HTML 入口檔:Cache-Control: no-cache(每次都向伺服器驗證)
這樣一來,瀏覽器只需要在每次部署後重新抓一份小小的 HTML,就能拿到最新的資源清單,其餘檔案全部命中快取。
開發階段若不想被快取干擾,也可以直接在 DevTools 的 Network 面板勾選 Disable cache,或用 fetch(url, { cache: 'no-store' }) 針對單一請求跳過快取。