驗證碼、圖表即時更新、使用者頭像修改等場景,常需以 JS 動態修改 <img> 的 src 重新載入圖片。但在 IE7、Firefox 等瀏覽器中,若新舊 src 相同,瀏覽器會直接讀取快取,導致圖片不更新。本文解析原理並提供通用解決方案。
<img id="captcha" src="/captcha.jpg" />
<span onclick="reloadCaptcha()" style="cursor:pointer">看不清,換一張</span>
IE6 正常,IE7+、Firefox、Chrome 圖片不變(讀取快取)。
src 為相同字串,瀏覽器判定無變化,略過網路請求。function reloadCaptcha() {
var img = document.getElementById('captcha');
// 方法 1:時間戳(推薦,無碰撞)
img.src = '/captcha.jpg?t=' + Date.now();
// 方法 2:隨機數(簡單)
// img.src = '/captcha.jpg?' + Math.random();
// 方法 3:遞增計數器(避免快取汙染)
// img.src = '/captcha.jpg?v=' + (++window._captchaVer);
}
原理:URL 變化 → 瀏覽器視為新資源 → 發起新請求 → 獲取最新圖片。
/**
* 強制重新載入圖片(破解快取)
* @param {HTMLImageElement|string} imgEl - 圖片元素或選擇器
* @param {string} [baseUrl] - 可選,指定基礎 URL(預設用當前 src 移除查詢字串)
*/
function forceReloadImage(imgEl, baseUrl) {
var img = typeof imgEl === 'string' ? document.querySelector(imgEl) : imgEl;
if (!img) return;
var src = baseUrl || img.src.split('?')[0]; // 移除舊查詢參數
var separator = src.includes('?') ? '&' : '?';
img.src = src + separator + 't=' + Date.now();
}
// 使用
forceReloadImage('#captcha'); // 自動用當前 src
forceReloadImage('#chart', '/api/chart'); // 指定基礎 URL
前端加隨機參數是「治標」,後端設定正確 Header 才是「治本」:
// Java Servlet 範例
response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate, max-age=0");
response.setHeader("Pragma", "no-cache");
response.setDateHeader("Expires", 0);
response.setContentType("image/jpeg");
// 輸出圖片二進位 ...
若後端正確設定 no-store,前端甚至不需加隨機參數(但為保險建議雙重保障)。
| 場景 | 解決方式 |
|---|---|
| 使用者上傳頭像後預覽不更新 | 上傳成功後 avatar.src = '/api/avatar/' + uid + '?t=' + Date.now() |
| ECharts/Highcharts 圖表定時刷新 | 圖表容器重繪或 setOption,非 img src 問題 |
| CSS 背景圖更新 | el.style.backgroundImage = 'url(/bg.jpg?t=' + Date.now() + ')' |
| Favicon 動態變更 | document.querySelector('link[rel=icon]').href = '/favicon.ico?t=' + Date.now() |
Math.random() 當唯一性依據:極小機率碰撞,Date.now() 或計數器更可靠。cache: 'no-store'。一行 Date.now() 解決十年老問題,這就是 Web 開發的實用智慧。