每次用戶請求到達Spring Boot服務端，你是否需要重復寫日志、權限檢查或請求格式化代碼？這些繁瑣的“前置后置”工作讓人頭疼！好在，Spring Boot攔截器如同一道智能關卡，統一處理請求的橫切邏輯，讓代碼優雅又高效。X平臺@SpringBootDev稱它為“微服務請求管道的衛兵”！數據顯示，合理使用攔截器可減少50%的冗余代碼，提升30%的開發效率。想讓你的Spring Boot項目更簡潔、性能更優？本文從原理到實戰，帶你玩轉攔截器。
Spring Boot攔截器是什么？它如何簡化請求處理？如何快速實現一個攔截器并應用到項目中？
在一個成熟的Web系統中，登錄校驗、日志記錄、權限控制、接口限流……這些通用邏輯你是否每次都要手動復制粘貼？如果你正在使用SpringBoot框架，恭喜你，有一個“幕后英雄”早已為你準備好了優雅的解決方案——攔截器（Interceptor）！
那么，SpringBoot中的攔截器到底能做什么？它和過濾器、切面之間有什么區別？又該如何在項目中靈活應用？
觀點與案例結合
Spring Boot攔截器基于Spring MVC的HandlerInterceptor接口，通過預處理、后處理和完成處理三個階段，靈活管理請求流程。以下是核心原理與實戰案例，助你快速上手。
攔截器基于Spring MVC，依賴于HandlerInterceptor接口，在請求處理前后發揮作用，具備三大核心方法：
-
preHandle：在控制器執行前調用，可用于登錄驗證。 -
postHandle：控制器處理完畢但未渲染視圖時調用。 -
afterCompletion：整個請求完成后調用，可用于資源清理或異常處理。
1. 攔截器原理：請求生命周期的控制
核心：攔截器在請求到達控制器前（preHandle）、后（postHandle）和響應完成（afterCompletion）執行邏輯。
-
preHandle：請求到達控制器前，適合權限驗證、參數校驗。
-
postHandle：控制器處理后，視圖渲染前，適合修改響應數據。
-
afterCompletion：響應完成后，適合清理資源、記錄日志。
流程圖：
請求 -> preHandle -> 控制器 -> postHandle -> 渲染視圖 -> afterCompletion -> 響應案例：某電商平臺用攔截器統一校驗用戶Token，攔截90%的非法請求，降低后端壓力。
實踐：理解HandlerInterceptor接口，準備自定義攔截器。
2. 自定義攔截器：實現業務邏輯
場景：記錄請求耗時和用戶身份驗證。
方法：實現HandlerInterceptor接口，重寫三個方法。
代碼（自定義攔截器）：
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;public class LoggingInterceptor implements HandlerInterceptor {private static final Logger logger = LoggerFactory.getLogger(LoggingInterceptor.class);@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {long startTime = System.currentTimeMillis();request.setAttribute("startTime", startTime);logger.info("Request URL: {} | Method: {}", request.getRequestURL(), request.getMethod());// 模擬權限校驗String token = request.getHeader("Authorization");if (token == null || token.isEmpty()) {response.setStatus(401);logger.warn("Unauthorized access: Missing token");return false;}return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {logger.info("Controller processed, preparing response");}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {long startTime = (Long) request.getAttribute("startTime");long duration = System.currentTimeMillis() - startTime;logger.info("Request completed in {}ms", duration);if (ex != null) {logger.error("Request failed: {}", ex.getMessage());}}
}說明：preHandle校驗Token并記錄開始時間，afterCompletion計算耗時并記錄異常。
案例：某微服務用攔截器記錄API耗時，發現慢接口，優化后響應時間從500ms降至200ms。
實踐：在Spring Boot項目中創建上述攔截器，測試日志輸出。
3. 注冊攔截器：應用到項目
場景：將攔截器應用到特定路徑或全局。
方法：通過WebMvcConfigurer注冊攔截器，指定攔截路徑。
代碼（攔截器配置）：
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new LoggingInterceptor()).addPathPatterns("/api/**") // 攔截/api/下的請求.excludePathPatterns("/api/public/**"); // 排除公共接口}
}說明：攔截/api/**路徑，排除/api/public/**，靈活控制范圍。
案例：某博客系統用攔截器對/api/admin/**路徑做權限校驗，防止未授權訪問，安全性提升100%。
實踐：在Spring Boot項目中添加上述配置，測試攔截效果。
4. 實戰應用：典型場景
場景1：日志記錄
-
用攔截器記錄請求URL、方法、耗時，上傳到ELK分析。
-
案例：某金融平臺通過攔截器日志發現高頻接口瓶頸，優化后吞吐量提升40%。
場景2：權限驗證
-
在preHandle檢查用戶Token或角色，攔截非法請求。
-
案例：某SaaS平臺用攔截器統一JWT驗證，減少控制器代碼50%。
場景3：請求預處理
-
統一處理請求頭、參數格式化或CORS設置。
-
案例：某跨境電商用攔截器添加CORS頭，支持跨域訪問，用戶體驗提升20%。
實踐：選擇一個場景（如JWT驗證），用攔截器實現并集成到項目。
5. 注意事項與優化
注意事項：
-
性能：攔截器邏輯需輕量，避免復雜計算影響性能。
-
順序：多個攔截器按注冊順序執行，注意邏輯沖突。
-
異常處理：在afterCompletion捕獲異常，防止漏報。
優化技巧： -
用ThreadLocal存儲請求上下文，避免重復計算。
-
結合Spring Security替換部分權限驗證邏輯，簡化攔截器。
案例：某高并發系統用ThreadLocal優化攔截器，減少10%的內存開銷。
實踐：在攔截器中添加ThreadLocal存儲用戶ID，測試性能提升。
| 對比維度 | 攔截器(Interceptor) | 過濾器(Filter) | AOP(面向切面編程) |
|---|---|---|---|
| 作用域 | 針對Spring MVC框架的請求處理流程 | Servlet容器級別的請求/響應處理 | 方法級別的橫切關注點 |
| 執行時機 | Controller方法調用前后、視圖渲染前后 | 請求到達Servlet前和響應返回前 | 方法執行前、后或異常時 |
| 實現方式 | 實現HandlerInterceptor接口 | 實現javax.servlet.Filter接口 | 通過切面(Aspect)、通知(Advice)等實現 |
| 依賴關系 | 依賴Spring MVC框架 | 依賴Servlet容器 | 依賴Spring AOP或AspectJ |
| 典型應用場景 | 權限檢查、日志記錄、參數預處理等 | 字符編碼設置、XSS防護、全局跨域處理等 | 事務管理、性能監控、緩存、異常處理等 |
| 優點 | 1. 與Spring集成度高 2. 可以獲取Handler信息 | 1. 更底層 2. 能處理靜態資源 | 1. 解耦性好 2. 功能強大靈活 |
| 缺點 | 1. 僅作用于Controller層 2. 功能相對簡單 | 1. 無法獲取Spring上下文 2. 不能精細控制處理流程 | 1. 學習曲線陡峭 2. 性能開銷相對較大 |
社會現象分析
隨著微服務架構的普及和接口安全日益重要，后端開發者對“統一入口控制”的需求愈發強烈。攔截器的使用，已經從“可選項”升級為“架構標配”。它在權限系統、接口防刷、接口日志、用戶行為記錄等方面被廣泛采納。
企業中，攔截器廣泛用于API網關、日志收集和安全防護，如銀行系統通過攔截器統一記錄交易日志，確保審計合規。開源社區（如Spring)的攔截器教程Star數超2萬，反映開發者對其依賴。攔截器不僅是技術工具，更是提升代碼質量和效率的利器。
總結與升華
SpringBoot攔截器，是連接前端請求與后端業務的“守門員”，掌握其使用，意味著你對Web請求處理流程的理解又邁進了一大步。
Spring Boot攔截器通過preHandle、postHandle和afterCompletion三階段，統一處理請求的日志、權限和預處理邏輯。它不僅簡化了代碼，還提升了系統的可維護性和性能。從日志記錄到權限驗證，攔截器是Spring Boot開發的得力助手。掌握攔截器，你的Web項目將更加優雅，開發效率一飛沖天！
攔截器之于SpringBoot，就像防火墻之于網絡——不可見，卻守護著系統的每一次請求安全。
