萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

解決遠程圖片緩存導致無法更新:URL 防緩存最佳實踐

問題根因

瀏覽器對靜態資源(圖片、CSS、JS)積極緩存。同一 URL 再次請求時直接讀取緩存,導致服務端圖片更新後前端仍顯示舊版。

核心方案:URL 參數指紋

在圖片 URL 後添加唯一查詢參數,強制瀏覽器視為新資源發起請求。

1. 時間戳版(每次請求不同,不利用緩存)

// 適用於極少數「必須實時」場景
img.src = `https://example.com/avatar.jpg?t=${Date.now()}`;
// 或
img.src = `https://example.com/avatar.jpg?v=${new Date().getTime()}`;

2. 版本號/哈希版(推薦:部署時更新,平時走緩存)

// 構建工具自動注入 hash
img.src = `https://example.com/avatar.jpg?v=abc123def`;
// 或路徑級 hash
img.src = `https://example.com/avatar.abc123def.jpg`;

構建工具配置示例:

  • Webpack: output.filename: '[name].[contenthash].js'
  • Vite: 內建支持 import.meta.glob + hash
  • Gulp/Grunt: gulp-rev / grunt-rev

3. 服務端 ETag / Last-Modified(標準 HTTP 緩存控制)

服務端正確設置 Cache-Control、ETag、Last-Modified,瀏覽器自動協商緩存,無需前端干預。

# Nginx 示例
location ~* \.(jpg|jpeg|png|gif|webp)$ {
  expires 1y;
  add_header Cache-Control "public";
  etag on;
}

jQuery/Axios/Vue/React 實際應用

// jQuery
$('.myImg').attr('src', 'yourUrl.action?rand=' + Date.now());

// Vue 3 組合式
const imgSrc = ref('avatar.jpg?v=' + import.meta.env.VITE_APP_VERSION);

// React


// Axios 請求攔截器添加時間戳(僅用於 API,圖片通常直接 )
axios.interceptors.request.use(config => {
  if (config.url.includes('/api/')) config.params = { ...config.params, _t: Date.now() };
  return config;
});

避坑指南

  • ❌ 不要對所有靜態資源加隨機時間戳,會導致緩存失效、頻寬浪費、服務器壓力增大。
  • ✅ 僅對「用戶上傳頭像、動態生成圖表、實時監控快照」等高頻更新資源使用防緩存參數。
  • ✅ 靜態構建產物(打包後的 JS/CSS/圖片)務必使用 內容哈希 作為文件名一部分,實現長期強緩存 + 精準失效。
  • ✅ 服務端正確配置 HTTP 緩存頭是根本解決之道。
copyright © 萬盛學電腦網 all rights reserved