近幾個月的工作是一個交易系統的持續改進專案,迭代發布週期大約 2 到 3 週。最近一次是 V16 版,星期三完成發布。不幸的是,隔天上午就被主管叫去問話——生產環境裡抓到一個 bug。
系統中有一個常用的自訂控制項,用來協助選擇客戶。V16 的需求是替它增加兩個篩選選項,支援不同的預設值設定。需求單純,程式碼改動也小,其中一處是替某個 JS 函式加上一個傳入參數,用來傳遞設定值。
經過 RC、RTW 測試,一切看起來都很正常。但一上生產就出問題了:載入出來的客戶清單明顯不對、數目不符,也與預期的查詢設定不一致。
追查控制項內部的跳轉連結後發現,傳遞的參數與預期不符,而這個連結正是由前面修改過的 JS 函式所產生。因此判定問題源自客戶端快取了舊版 JS 檔,新函式的呼叫被舊函式取代。清除快取、重新載入頁面後,控制項恢復正常。
麻煩的是,我們不可能打電話告訴每一位使用者「請清除快取」。
那一刻我才意識到,必須有一套控制 JS 快取的方法。否則後續任何涉及 JS 內容的修改,都可能因為快取而取不到新檔,釀成生產事故。
原則上,我們希望只有在 JS 有更新時才重新載入,而不是每次都重新抓。因此「在 JS 網址後面加上隨機參數」這個做法不可取——那意味著幾乎每次載入頁面都會重新下載 JS,完全浪費了快取帶來的好處。
如果你看過國外網站的程式碼,會發現它們通常在 JS 連結後面帶一個版本號參數,而不是隨機數。當 JS 內容有修改時,只需把版本號加一,就能巧妙地通知客戶端更新檔案。不知道誰是第一個想到這方法的人,但無疑值得欽佩——真是個好主意。
<script src="../JavaScript/SelectOpenWindow.js?v=1" type="text/javascript"></script>
手動維護版本號仍有缺點:容易忘記遞增,也容易在分支合併時漏掉。更穩健的方式是讓建置流程自動計算檔案內容的雜湊(例如 MD5 或 SHA-256),把指紋寫進檔名:
<script src="/js/main.a1b2c3d4.js"></script>
這樣內容不動、網址就不動,快取長期有效;內容一動、網址自動改變,快取自動失效。完全不必人工介入,這也是目前 webpack、Vite、Rollup 等工具的標準收尾步驟。
還有一個容易忽略的配套:被引入的 HTML 本身也需要控制快取。若 HTML 被快取了,它仍然指向舊檔名,雜湊策略就跟著失效。因此實務上通常把帶雜湊的靜態資源設為長期快取(例如 Cache-Control: max-age=31536000, immutable),而 HTML 則設為 no-cache 或短時間快取。