做專案時把圖片放在伺服器、路徑存進資料庫,再由瀏覽器顯示,是很常見的架構。但這個做法會遇到兩個限制,值得先釐清。
其一:JavaScript 基於安全考量無法讀取本機檔案系統。否則任何網頁都能掃描使用者電腦裡的資料,後果不堪設想。
其二:圖片位於伺服器而非用戶端。瀏覽器自然拿不到它的本機路徑。
網路上能找到的解法多半圍繞著各種二進位轉 XML 的繁複做法。以下記錄一個更直接的路線:透過後端把圖片讀進記憶體再輸出。
核心想法是把伺服器上的圖片載入記憶體,放進 BufferedImage 緩衝區,再用 ImageIO.write() 寫出到 HTTP 回應串流。這樣瀏覽器請求的就是一個「程式端點」而非靜態檔案,快取問題自然也跟著解決。
/**
* 依圖片路徑回傳緩衝影像物件
* @param addr 圖片路徑
* @return BufferedImage
*/
public static BufferedImage getInputStream(String addr) {
try {
String imgPath = addr;
BufferedImage image = ImageIO.read(new FileInputStream(imgPath));
return image;
} catch (Exception e) {
e.printStackTrace();
System.out.println();
System.out.println("取得圖片異常:java.awt.image.BufferedImage");
System.out.println("請檢查圖片路徑是否正確,或該路徑是否指向一個圖片檔");
}
return null;
}
關鍵就是 ImageIO.read(),它把檔案內容讀成 BufferedImage 物件。需要留意的是 FileInputStream 沒有被關閉,實務上應改用 try-with-resources 確保資源釋放。
以下以 Spring MVC 為例:
/**
* 依圖片路徑輸出圖片
* @param addr 圖片路徑
* @param response HTTP 回應
*/
@ResponseBody
@RequestMapping("/getImg")
public void getImg(@Param("addr") String addr, HttpServletResponse response) {
BufferedImage img = ImgUtil.getInputStream(addr);
if (img == null) {
throw new RuntimeException("輸出圖片異常:Business_Ctrl.getImg(String, HttpServletResponse)");
}
try {
ImageIO.write(img, "JPEG", response.getOutputStream());
} catch (IOException e) {
e.printStackTrace();
System.out.println("輸出異常:Business_Ctrl.getImg(String, HttpServletResponse)");
}
}
讀取用 ImageIO.read(),輸出用 ImageIO.write(),而輸出的目的地就是 HttpServletResponse.getOutputStream()。此外,正確的 Content-Type 標頭不可省略,否則瀏覽器可能無法辨識回應內容:
response.setContentType("image/jpeg");
function setImg(addr) {
$("#logo").attr("src", "business/getImg?addr=" + addr);
}
需要載入圖片時呼叫 setImg 並傳入路徑,即可讓 img 標籤指向這個端點。路徑本身通常早已由後端傳到前端;即使沒有,也可以再開一個端點回傳,或直接由後端組出完整 URL。
順帶一提,這個寫法把 addr 直接串進查詢字串,存在目錄越權讀取(path traversal)的風險——攻擊者可以傳入 ../../etc/passwd 之類的路徑。實務上必須對輸入做白名單驗證,或改用資料庫 ID 查表取得實際路徑。
如果目的是「讓瀏覽器不要快取某個請求」,其實不必繞這麼一大圈。jQuery 自 1.2 版起就提供了兩個參數,不需要手動設定 HTTP 標頭。
cache(Boolean,預設 true):設為 false 會強制該請求不被瀏覽器快取。jQuery 的做法是在網址後附加一個時間戳參數。
ifModified(Boolean,預設 false):僅當回應自上次請求後有變動時才視為成功,原理是檢查 Last-Modified 標頭。
$.ajax({
type: "GET",
url: "static/cache.js",
dataType: "text",
cache: false,
ifModified: true
});
這兩個參數正好對應兩種不同需求:cache: false 是「永遠要最新的」,ifModified: true 是「沒變就用區域快取」。多數時候後者更省頻寬,因為伺服器只需回傳 304。
釐清需求後會發現,這兩段內容其實在解釋不同的問題。若圖片本來就存放於伺服器檔案系統,單純用 <img src="靜態路徑"> 即可,加一個版本號或時間戳參數就能破快取:
$("#logo").attr("src", "/images/logo.jpg?v=" + new Date().getTime());
只有當圖片需要經過後端運算、權限檢查或動態產生時,才需要走 ImageIO.write() 那條代理輸出的路線。而清除 JS/CSS 快取則一律交給 cache: false 或版本號機制處理即可,成本遠低於自建端點。