在構建符合 RESTful 原則或追求用戶體驗流暢性的 Web 應用時，“重定向后刷新”（PRG - Post/Redirect/Get）模式是避免表單重復提交、實現頁面無刷新跳轉的黃金法則。然而，重定向（REDIRECT:）的本質是客戶端發起一次全新的 GET 請求，原始請求中的數據（如成功/錯誤消息、表單暫存值）如何在兩次請求間安全傳遞？Spring MVC 的?FlashMapManager?接口及其配套機制，正是為解決這一核心痛點而生的優雅設計，它如同一位隱形的信使，在重定向的間隙悄然傳遞關鍵信息。

一、 核心挑戰：跨重定向請求的屬性傳遞

設想一個典型場景：

1. 用戶提交表單（POST?/submit）。

2. 服務器處理成功，需要重定向到結果頁面（GET?/result）以避免刷新導致重復提交。

3. 同時，服務器需在結果頁面上顯示一條“操作成功”的消息。

問題核心：POST 請求處理過程中生成的“成功消息”如何安全、可靠地傳遞到后續的 GET 請求中？

• HttpSession?直接存儲：可行但笨重。需手動存/取/清理屬性，易導致 Session 膨脹，并發場景需處理屬性命名沖突。

• URL 拼接參數：如?/result?msg=Success。暴露信息、長度受限、不適用于敏感或復雜數據。

• 請求轉發（Forward）：能保留請求屬性，但瀏覽器地址欄不更新，刷新可能導致重新提交。

FlashMapManager?的設計目標清晰：提供一種輕量級、安全、自動清理的機制，在重定向操作前暫存數據，并在重定向后的目標請求中自動恢復這些數據，且僅限一次訪問。

二、 FlashMap 與 FlashMapManager：協作的孿生核心

解決方案的核心是兩個緊密協作的組件：

1. FlashMap：數據的載體容器。

• 本質是一個?Map<String, Object>，用于存儲需要在重定向間傳遞的鍵值對（如?"successMessage" -> "操作成功!"）。

• 關鍵屬性：
  *?targetRequestPath：指定此?FlashMap?應應用到的目標請求路徑（可選，用于精確匹配）。
  *?expirationTime：設置過期時間戳，確保數據不會無限期駐留。

1. FlashMapManager：接口定義管理?FlashMap?的生命周期。

public interface FlashMapManager {@NullableFlashMap retrieveAndUpdate(HttpServletRequest request, HttpServletResponse response);void saveOutputFlashMap(FlashMap flashMap, HttpServletRequest request, HttpServletResponse response);
}

• saveOutputFlashMap(FlashMap flashMap, ...)：

  • 在重定向發生前（通常在?DispatcherServlet?處理內部重定向邏輯時），由框架調用。

  • 職責：將當前請求上下文中準備好的?FlashMap?安全地存儲起來，供后續重定向請求檢索。

  • 存儲位置：通常基于?HttpSession?(默認實現)，也可自定義（如分布式緩存）。

• retrieveAndUpdate(HttpServletRequest request, ...)：

  • 在重定向后的目標請求到達時（DispatcherServlet?開始處理新請求時），由框架調用。

  • 職責：

  1. 根據當前請求信息（如路徑、Session ID）查找匹配的?FlashMap。

  2. 將找到的?FlashMap?中的數據提取并放入當前請求的屬性中（默認屬性名?DispatcherServlet.OUTPUT_FLASH_MAP_ATTRIBUTE）。

  3. 將已使用的?FlashMap?標記為過期或直接移除，確保數據僅被目標請求訪問一次。

  • 返回值：找到的?FlashMap（框架內部使用）。

三、 開發者視角：簡潔的 RedirectAttributes API

Spring MVC 并未讓開發者直接操作底層的?FlashMapManager?和?FlashMap，而是提供了更友好、更語義化的?RedirectAttributes?接口：

public interface RedirectAttributes extends Model {RedirectAttributes addFlashAttribute(String attributeName, @Nullable Object attributeValue);RedirectAttributes addFlashAttribute(Object attributeValue);// ... 其他方法如 addAttribute (會拼接到URL)
}

使用流程 (Controller 內)：

1. 準備重定向：

   @PostMapping("/submit")
   public String handleSubmit(..., RedirectAttributes redirectAttrs) {// 業務處理...// 添加 Flash 屬性 (不暴露在URL)redirectAttrs.addFlashAttribute("successMessage", "數據保存成功！");// 添加普通屬性 (會拼接到重定向URL)redirectAttrs.addAttribute("id", savedEntity.getId()); // -> /result?id=123return "redirect:/result";
   }

2. 在重定向目標中獲取：

   @GetMapping("/result")
   public String showResult(Model model) {// Flash 屬性已由框架自動從 FlashMap 取出并添加到 Model 中!// 可直接在視圖中通過 ${successMessage} 訪問return "resultView";
   }

設計優勢：

• 高度抽象：開發者只需操作?RedirectAttributes，完全屏蔽?FlashMapManager?的復雜性。

• 類型安全：addFlashAttribute?方法清晰區分 Flash 數據與 URL 參數。

• 自動集成：與 Spring MVC 的?Model?和視圖渲染無縫結合。

四、 核心實現：SessionFlashMapManager 剖析

Spring MVC 默認提供?org.springframework.web.servlet.support.SessionFlashMapManager，其工作原理如下：

1. 存儲 (saveOutputFlashMap)：

   • 獲取或創建當前 Session。

   • 從 Session 中獲取一個名為?FlashMapManager.FLASH_MAPS_SESSION_ATTRIBUTE?的?List<FlashMap>。

   • 將待保存的?FlashMap?添加到這個 List 中。

   • 將更新后的 List 存回 Session。

2. 檢索與更新 (retrieveAndUpdate)：

   • 從當前請求的 Session 中獲取?List<FlashMap>。

   • 遍歷 List：

     • 檢查?FlashMap?是否過期 (expirationTime < currentTime)。

     • 檢查?targetRequestPath?是否匹配當前請求路徑（如果設置了）。

     • 如果找到匹配且未過期的?FlashMap：

       • 將其數據放入當前請求的屬性中。

       • 將其從 List 中移除（確保一次性訪問）。

       • 將更新后的 List 存回 Session（移除了已使用的 FlashMap）。

   • 返回找到的?FlashMap?(內部使用)。

3. 過期清理：

   • retrieveAndUpdate?方法在查找時同步清理過期項。即使目標請求未觸發匹配，過期的?FlashMap?也會在下次任何請求調用?retrieveAndUpdate?時被清除。

   • 提供?setFlashMapTimeout(int seconds)?設置 FlashMap 默認存活時間（默認 180 秒）。

五、 設計精妙之處

1. “一次性”語義保障：通過檢索后立即移除的機制，嚴格確保 Flash 屬性僅對重定向后的第一個請求可見。刷新?/result?頁面不會再次顯示消息，符合 PRG 模式預期。

2. 請求隔離與精確投遞：

   • targetRequestPath?允許將 Flash 數據精準關聯到特定目標 URL，避免在無關請求中泄露。

   • 基于 Session ID 的存儲自然隔離不同用戶的數據。

3. 自動垃圾回收：內置的過期檢查和清理機制有效防止 Session 因殘留 FlashMap 而膨脹。

4. 可插拔的存儲策略：FlashMapManager?是接口。默認?SessionFlashMapManager?適用于大多數應用。在分布式/無狀態場景下，可輕松實現基于 Redis、Memcached 或數據庫的?FlashMapManager?替代 Session 存儲。

5. 與框架深度集成：

   • DispatcherServlet?在內部流程關鍵點（處理重定向前、處理新請求前）自動調用?FlashMapManager?的方法。

   • RequestMappingHandlerAdapter?在調用 Controller 方法前，將檢索到的 FlashMap 數據合并到?Model?中。

六、 最佳實踐與考量

• 內容類型：適合傳遞短小、非敏感的即時消息（成功/失敗提示）、表單校驗錯誤對象（BindingResult）、或少量需要在重定向后頁面顯示的臨時狀態數據。切勿用于傳遞大型對象或敏感信息。

• 命名規范：使用清晰、一致的屬性名（如?message,?errorMessage,?info）。

• 分布式環境：默認?SessionFlashMapManager?依賴 Session 親和性（Sticky Session）。在集群部署且 Session 不共享時，必須實現自定義的分布式?FlashMapManager。

• 自定義實現：實現?FlashMapManager?接口，重寫?saveOutputFlashMap?和?retrieveAndUpdate?方法，選擇所需的存儲后端（如 Redis）。注冊自定義 Bean 覆蓋默認實現。

• 測試：Spring 提供了?MockFlashMapManager?方便單元測試 Controller 中的重定向和 Flash 屬性邏輯。