萬盛學電腦網

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

JavaScript 修改圖片 src 不生效?IE7/Firefox 快取導致驗證碼不刷新的解決方案

經典問題:JS 修改 img.src 同網址不重新載入,隨機參數破解瀏覽器快取

驗證碼、圖表即時更新、使用者頭像修改等場景,常需以 JS 動態修改 <img> 的 src 重新載入圖片。但在 IE7、Firefox 等瀏覽器中,若新舊 src 相同,瀏覽器會直接讀取快取,導致圖片不更新。本文解析原理並提供通用解決方案。

問題重現

<img id="captcha" src="/captcha.jpg" />
<span onclick="reloadCaptcha()" style="cursor:pointer">看不清,換一張</span>

IE6 正常,IE7+、Firefox、Chrome 圖片不變(讀取快取)。

核心原理

  • 瀏覽器快取機制:URL 為唯一鍵值。相同 URL → 直接讀取快取(若未過期/未設 no-cache)。
  • 驗證碼、動態圖表等後端常以同一 URL 返回不同二進位內容。
  • 修改 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

前端加隨機參數是「治標」,後端設定正確 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()

避坑提醒

  1. 不要用 Math.random() 當唯一性依據:極小機率碰撞,Date.now() 或計數器更可靠。
  2. 注意 URL 長度限制:查詢字串過長可能超過伺服器限制(通常 2048/8192 字元),時間戳僅 13 位數安全。
  3. HTTPS 頁面請求 HTTP 圖片會被阻擋:確保圖片 URL 協議一致。
  4. Service Worker 快取:PWA 專案需在 SW 中排除動態圖片路由或加入 cache: 'no-store'。

一行 Date.now() 解決十年老問題,這就是 Web 開發的實用智慧。

copyright © 萬盛學電腦網 all rights reserved