以下內(nèi)容是來(lái)自 Spring Framework 官方文檔 中關(guān)于 HTTP 緩存（HTTP Caching） 的部分，特別是針對(duì) WebFlux 和 Web MVC 框架的說(shuō)明。下面我將用通俗易懂的方式為你逐段解析，并幫助你理解其核心概念和實(shí)際應(yīng)用。

一、什么是 HTTP 緩存？

原文開(kāi)頭：

HTTP caching can significantly improve the performance of a web application.

HTTP 緩存是一種優(yōu)化機(jī)制，它的目標(biāo)是：
?? 讓瀏覽器或中間代理服務(wù)器（如 CDN）避免重復(fù)下載相同的資源，從而：

• 減少網(wǎng)絡(luò)請(qǐng)求
• 節(jié)省帶寬
• 提升頁(yè)面加載速度
• 降低后端服務(wù)器壓力

核心原理：Cache-Control+ 條件請(qǐng)求（ETag / Last-Modified）

• Cache-Control 頭
  • 控制資源可以被誰(shuí)緩存、緩存多久。
  • 例如：Cache-Control: max-age=3600 表示“這個(gè)響應(yīng)可以緩存 1 小時(shí)”。
• 條件請(qǐng)求頭（Conditional Request Headers）
  • 當(dāng)緩存過(guò)期或需要驗(yàn)證是否更新時(shí)，瀏覽器會(huì)帶上：
  • 如果內(nèi)容沒(méi)變，服務(wù)器就返回 304 Not Modified（不傳正文），節(jié)省傳輸開(kāi)銷。

If-None-Match: 對(duì)應(yīng)服務(wù)器之前返回的 ETag

If-Modified-Since: 對(duì)應(yīng)之前的 Last-Modified

二、CacheControl類：簡(jiǎn)化 Cache-Control 配置

Spring 提供了一個(gè)工具類 CacheControl，讓你不用手動(dòng)拼字符串設(shè)置 Cache-Control 頭。

示例代碼解析：

// 緩存1小時(shí)："Cache-Control: max-age=3600"
CacheControl.maxAge(1, TimeUnit.HOURS);
// 禁止緩存："Cache-Control: no-store"
CacheControl.noStore();
// 自定義策略
CacheControl.maxAge(10, TimeUnit.DAYS)
            .noTransform()
            .cachePublic();
// 結(jié)果："max-age=864000, public, no-transform"

?? 這些方法鏈?zhǔn)秸{(diào)用，語(yǔ)義清晰，比直接寫(xiě) header 更安全、易讀。

 三、在控制器中使用 HTTP 緩存（Controllers）

這是最常見(jiàn)也最重要的場(chǎng)景 —— 給動(dòng)態(tài)接口加上緩存支持。

? 推薦做法：返回ResponseEntity并添加 ETag 和 Cache-Control

@GetMapping("/book/{id}")
public ResponseEntity<Book> showBook(@PathVariable Long id) {
    Book book = findBook(id);
    String version = book.getVersion(); // 如數(shù)據(jù)庫(kù)版本號(hào)、hash值等
    return ResponseEntity
        .ok()
        .cacheControl(CacheControl.maxAge(30, TimeUnit.DAYS)) // 緩存30天
        .eTag(version)  // 設(shè)置ETag
        .body(book);
}

發(fā)生了什么？

• 第一次請(qǐng)求：
• 返回狀態(tài)碼 200 OK
• 響應(yīng)頭包含：

ETag: "abc123"
Cache-Control: max-age=2592000

• 瀏覽器下次請(qǐng)求同一 URL：
• 自動(dòng)帶上：

If-None-Match: "abc123"

• Spring 檢查發(fā)現(xiàn) ETag 相同 → 返回 304 Not Modified（空 body）

瀏覽器直接使用本地緩存！

? 效果：節(jié)省流量，提升用戶體驗(yàn)。

?? 手動(dòng)檢查條件請(qǐng)求（更靈活控制）

有時(shí)候你想先判斷是否需要處理業(yè)務(wù)邏輯：

@RequestMapping
public String myHandleMethod(WebRequest request, Model model) {
    long eTag = bookService.getCurrentVersion(); // 應(yīng)用級(jí)計(jì)算ETag
    if (request.checkNotModified(eTag)) {
        return null; // 不再執(zhí)行后續(xù)邏輯，自動(dòng)返回304
    }
    model.addAttribute("data", ...);
    return "myViewName";
}

checkNotModified()做了什么？

• 比較客戶端發(fā)來(lái)的 If-None-Match 或 If-Modified-Since 是否匹配。
• 匹配 → 設(shè)置響應(yīng)為 304 Not Modified，并終止處理 → 返回 null
• 不匹配 → 正常繼續(xù)處理請(qǐng)求

?? 注意：

• 對(duì)于 GET/HEAD 請(qǐng)求，返回 304
• 對(duì)于 POST/PUT/DELETE 請(qǐng)求，若條件不滿足，應(yīng)返回 412 Precondition Failed（防止并發(fā)修改）

四、靜態(tài)資源緩存（Static Resources）

比如 JS、CSS、圖片等文件，非常適合長(zhǎng)期緩存。

建議配置：

• 設(shè)置長(zhǎng)時(shí)間的 Cache-Control: max-age=31536000（一年）
• 使用內(nèi)容指紋命名（如 app.a1b2c3.js），確保更新后 URL 改變，打破緩存

這樣既能充分利用緩存，又能保證更新生效。

文檔提示參考 “Configuring Static Resources” 進(jìn)行詳細(xì)配置（通常通過(guò) Spring Boot 的 spring.web.resources.cache 配置項(xiàng)實(shí)現(xiàn)）

五、Shallow ETag Filter（淺層 ETag 過(guò)濾器）

問(wèn)題引入：

上面我們手動(dòng)設(shè)置了 ETag，但如果你不想自己管理 ETag 怎么辦？
Spring 提供了一種自動(dòng)方案：ShallowEtagHeaderFilter

特點(diǎn)：

使用方式（web.xml 或 Java Config 添加過(guò)濾器）：

<filter>
    <filter-name>etagFilter</filter-name>
    <filter-class>org.springframework.web.filter.ShallowEtagHeaderFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>etagFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

?? 注意：它只對(duì) GET 請(qǐng)求有效，且必須等到整個(gè)響應(yīng)生成完才計(jì)算 ETag，所以不能減少服務(wù)器計(jì)算量，只能減少傳輸量。

? 總結(jié)：如何理解并運(yùn)用 HTTP 緩存？

?? 實(shí)際應(yīng)用場(chǎng)景舉例

場(chǎng)景1：圖書(shū)詳情頁(yè) API

@GetMapping("/api/books/{id}")
public ResponseEntity<Book> getBook(@PathVariable Long id, WebRequest request) {
    Book book = bookService.findById(id);
    String etag = book.getUpdatedAt().toString(); // 或 MD5(content)
    if (request.checkNotModified(etag)) {
        return null;
    }
    return ResponseEntity.ok()
        .cacheControl(CacheControl.maxAge(1, TimeUnit.HOURS))
        .eTag(etag)
        .body(book);
}

效果：

• 內(nèi)容未變 → 返回 304，極快響應(yīng)
• 內(nèi)容變了 → 返回 200 + 新數(shù)據(jù)

場(chǎng)景2：首頁(yè) HTML（不希望緩存）

@GetMapping("/")
public String home(Model model, WebRequest request) {
    String etag = System.currentTimeMillis() / 3600 + ""; // 每小時(shí)變化
    if (request.checkNotModified(etag)) {
        return null;
    }
    model.addAttribute("time", new Date());
    return "home";
}

搭配 Cache-Control: max-age=3600，實(shí)現(xiàn)每小時(shí)最多重新生成一次。

 學(xué)習(xí)建議

• 動(dòng)手實(shí)驗(yàn)：用 Postman 或?yàn)g覽器開(kāi)發(fā)者工具觀察請(qǐng)求頭的變化。
• 查看 Network Tab：注意 200 vs 304 的區(qū)別，以及請(qǐng)求/響應(yīng)頭中的 ETag, If-None-Match, Cache-Control。
• 結(jié)合 Spring Boot：使用 application.yml 配置靜態(tài)資源緩存：

spring:
  web:
    resources:
      cache:
        cachecontrol:
          max-age: 1h

如有具體需求（比如“我想讓某個(gè)接口緩存一天”，或“為什么我的 ETag 沒(méi)生效？”），歡迎繼續(xù)提問(wèn)！

到此這篇關(guān)于Spring HTTP緩存全解析的文章就介紹到這了,更多相關(guān)Spring HTTP緩存內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論