近幾個月的工作是一個交易系統的持續改良專案,迭代週期大約兩到三週。最近一次發佈是 V16 版,週三完成上線。不幸的是,隔天上午就被主管叫去——生產環境裡出現了一個 bug。
系統裡有一個常用的自訂控制項,用來協助選擇客戶。V16 的改良需求是給它增加兩個篩選選項,支援不同的預設值設定。需求很簡單,程式碼改動也小,其中一處是給某個 js 檔案裡的函數多加了兩個傳入參數,用來傳遞設定值。
經過 RC、RTW 測試,一切看起來都很正常。但一上生產就出問題了:載入出來的客戶明顯不正常、數目不對,也與預期的查詢設定不符。
檢查控制項內部的跳轉連結後找到了線索——傳遞的參數明顯與預期不符,而這個連結正是由上面修改過的 JS 函數產生的。也就是說,客戶端快取了舊版的 JS 檔案,新函數的呼叫被舊函數實作所取代。清除快取、重新載入頁面後,控制項立刻恢復正常。
問題在於:我們不可能打電話告訴每一位使用者「請清除快取」。從那一刻起,我才意識到必須有一套機制來管理 JS 的快取,否則後續任何涉及 JS 內容的修改,都可能因為快取而讓使用者執行到過時的程式碼,釀成生產事故。
原則上我們想要的效果是:只有在 JS 有更新時才重新載入,而不是每次都重新下載。所以最直白的做法——在 JS 網址後面加一個隨機數——反而不可取。它確實能保證每次都拿到最新檔案,但代價是徹底放棄了快取帶來的效能與頻寬優勢。
如果仔細看過一些國外網站的原始碼,會發現他們通常在 js 連結後帶一個版本號參數,而不是隨機數:
<script src="../JavaScript/SelectOpenWindow.js?v=1" type="text/javascript"></script>
這樣一來,當 JS 內容有修改時,只需要把版本號加一:
<script src="../JavaScript/SelectOpenWindow.js?v=2" type="text/javascript"></script>
對瀏覽器和 CDN 來說,這是一個全新的 URL,快取自然失效,於是抓取新檔案;而在沒有更新的期間,同一個 URL 讓快取一路生效。既解決了更新通知問題,又保留了快取的好處。
不知道誰是第一個想到這招的人,但無疑值得欽佩——真是個漂亮的點子。
版本號要能自動化。手動維護 ?v=1、?v=2 遲早會忘記加。常見做法是讓建置流程把檔案的雜湊值(例如 MD5 前八碼)寫進 URL,app.js?v=a3f8c1d2,內容變了雜湊就變,完全不必人工介入。Webpack、Vite 這類打包工具的 contenthash 就是這個思路。
用檔名而非查詢參數更徹底。有些 CDN 或代理伺服器會忽略查詢字串做快取鍵,此時 select-open-window.a3f8c1d2.js 這種把雜湊放進檔名的做法更可靠。
伺服器端也要設定快取標頭。帶版本號的靜態資源可以大膽設定長期快取(Cache-Control: public, max-age=31536000, immutable),因為內容不變時 URL 就不變;而 HTML 本身則應該設為 no-cache,確保使用者總是能拿到指向最新版本的那份頁面。這兩者是相輔相成的,少了 HTML 不快取這一環,版本號機制一樣會失效。
這個事故帶來的教訓其實很單純:前端資源的快取不是瀏覽器的內部細節,而是部署設計的一部分。它需要被納入發佈流程,而不是等使用者回報異常時才手忙腳亂地請對方清除快取。