迭代 V16 發布後,自定義控件新增篩選參數,JS 函數簽名變更。測試環境正常,生產環境用戶因瀏覽器緩存舊版 JS導致參數傳遞錯誤、功能異常。無法逐個通知用戶清除緩存——緩存失效策略缺失是嚴重工程缺陷。
| 策略 | 實現 | 優點 | 缺點 | 評價 |
|---|---|---|---|---|
| 無版本號 | <script src="app.js"> | 最簡單 | 更新不生效,強制用戶清緩存 | ❌ 不可用 |
| 隨機參數 | <script src="app.js?v=Math.random()"> | 每次必獲取最新 | **完全失去緩存優勢**,每次請求重新下載,白白浪費頻寬、增加服務器壓力 | ❌ 反模式 |
| 版本號/哈希 | <script src="app.js?v=1.2.3"> 或 app.abc123.js | **精準失效**:文件變更才更新 URL,未變更走緩存 | 需構建流程配合 | ✅ 行業標準 |
<!-- 手動修改版本號 -->
<script src="../js/SelectOpenWindow.js?v=16"></script>
缺點:人工易忘、衝突、無法關聯 Git 提交。
// Webpack 配置
new HtmlWebpackPlugin({
template: 'index.html',
filename: 'index.html',
// 注入構建時間戳或 Git 短哈希
hash: true, // 生成 ?hash=abc123
// 或自定義
templateParameters: {
VERSION: require('child_process').execSync('git rev-parse --short HEAD').toString().trim()
}
});
<!-- 模板中使用 -->
<script src="app.js?v=<%= VERSION %>"></script>
// Webpack 生產配置
output: {
filename: 'js/[name].[contenthash:8].js', // 如 app.a1b2c3d4.js
chunkFilename: 'js/[name].[contenthash:8].chunk.js'
}
優勢:
Cache-Control: max-age=31536000, immutable[contenthash] 或 [chunkhash]HtmlWebpackPlugin / vite-plugin-html 自動注入帶哈希的腳本標籤location ~* \.(js|css|png|jpg|woff2)$ {
expires 1y;
add_header Cache-Control "public, immutable";
# 文件名含哈希,安全永久緩存
}
// Webpack 自動處理 import() 產出的 chunk 文件名含哈希
const module = await import('./lazyModule'); // 請求 lazyModule.a1b2c3d4.js
// package.json 鎖定精確版本
"lodash": "4.17.21" // 而非 ^4.17.21
// 或使用 npm ci 確保鎖定文件一致性
<style><?= file_get_contents('dist/critical.css') ?></style>
// 關鍵路徑資源內聯,避免額外請求,不涉及緩存問題
JS 緩存管理的核心原則:
內容變則 URL 變,內容不變則 URL 不變
從手動 ?v=1 到構建時 [contenthash],本質是將「失效決策權」從人工轉移給構建系統。現代前端工程中,配置一次 Webpack/Vite 輸出哈希文件名,配合 Nginx 永久緩存,即可一勞永逸解決緩存失效問題——這才是專業前端工程師的基本功。