非控制器（如 Service、工具類）中便捷地獲取當前 HTTP 請求的上下文信息
在 Spring 框架的 Web 開發中，RequestContextHolder 是一個非常實用的工具類，它的主要作用是在非控制器（如 Service、工具類）中便捷地獲取當前 HTTP 請求的上下文信息，避免了通過方法參數層層傳遞 HttpServletRequest 對象的繁瑣。
核心原理
Spring 在處理 HTTP 請求時，會將當前請求的 HttpServletRequest 對象存儲到 ThreadLocal 中（ThreadLocal 是線程局部變量，可確保多線程環境下數據隔離）。RequestContextHolder 則通過封裝對 ThreadLocal 的操作，提供了獲取這些上下文信息的靜態方法，讓開發者無需依賴參數傳遞就能訪問請求相關對象。
常用方法
- 獲取請求對象：
- HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
這是最常用的方式，通過 getRequestAttributes() 獲取封裝了請求信息的 ServletRequestAttributes 對象，再從中提取 HttpServletRequest。
- 獲取響應對象：
- HttpServletResponse response = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getResponse();
同理，可獲取當前請求對應的響應對象。
- 判斷是否存在請求上下文：
- boolean hasContext = RequestContextHolder.getRequestAttributes() != null;
用于避免在非 Web 環境（如單元測試、定時任務）中調用時出現空指針異常。
使用場景
-
Service 層獲取請求信息：例如在 Service 中需要獲取客戶端 IP 地址、請求頭（如 Token）等，可通過 RequestContextHolder 直接獲取，無需在 Controller 層將這些信息作為參數傳入 Service。
-
工具類中處理請求相關邏輯：比如日志工具類需要記錄請求 URL、方法等信息，通過該工具類可簡化代碼。
注意事項
-
僅在 Web 線程中有效：RequestContextHolder 依賴于 Spring 的請求處理線程，在異步線程（如 @Async 標注的方法）或非 Web 環境中調用，會返回 null，可能導致空指針異常，使用前需先判斷上下文是否存在。
-
避免過度依賴：雖然方便，但過度在 Service 層使用請求對象會增加代碼與 Web 環境的耦合性，不利于單元測試（非 Web 環境下需額外模擬上下文）。建議僅在必要時使用，優先通過參數傳遞關鍵信息。
-
線程安全問題：由于基于 ThreadLocal，在多線程場景下無需擔心線程安全問題，但需注意異步操作中無法共享父線程的請求上下文（需手動傳遞或配置線程池繼承上下文）。
總之，RequestContextHolder 是 Spring 簡化 Web 請求上下文訪問的重要工具，合理使用能提升開發效率，但需注意其適用場景和潛在風險，避免濫用導致代碼耦合性過高。
