快捷導(dǎo)航

Spring中過濾器和攔截器的區(qū)別及具體實(shí)現(xiàn)方式

更新時(shí)間：2025年07月10日 09:45:35 作者：鄧不利東

在Spring框架中,和都是用于處理 HTTP 請(qǐng)求的中間件,但它們?cè)谧饔梅秶?shí)現(xiàn)方式和生命周期上有顯著區(qū)別,本文給大家介紹Spring中過濾器和攔截器的區(qū)別及具體實(shí)現(xiàn),感興趣的朋友一起看看吧

核心區(qū)別

特性	過濾器 (Filter)	攔截器 (Interceptor)
規(guī)范	Servlet 規(guī)范 (J2EE 標(biāo)準(zhǔn))	Spring 框架特有
作用范圍	所有 Web 資源（Servlet、JSP、靜態(tài)資源）	僅 Spring MVC 管理的 Controller 請(qǐng)求
依賴	依賴 Servlet 容器（如 Tomcat）	依賴 Spring 容器
攔截時(shí)機(jī)	在請(qǐng)求進(jìn)入 Servlet 前 / 響應(yīng)發(fā)送到客戶端前	在請(qǐng)求進(jìn)入 Controller 前 / 后 / 視圖渲染后
獲取 Spring Bean	不能直接獲?。ㄐ柰ㄟ^工具類）	可直接獲取 Spring Bean
異常處理	無法使用 Spring 的異常處理機(jī)制	可結(jié)合 `@ControllerAdvice` 統(tǒng)一異常處理

實(shí)現(xiàn)方式

1. 過濾器 (Filter) 實(shí)現(xiàn)

過濾器是 Servlet 規(guī)范的一部分，通過實(shí)現(xiàn) javax.servlet.Filter 接口實(shí)現(xiàn)。

步驟：

創(chuàng)建 Filter 類

import javax.servlet.*;
import java.io.IOException;
public class CustomFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) {
        // 初始化邏輯
    }
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
        throws IOException, ServletException {
        // 1. 請(qǐng)求到達(dá) Controller 前的邏輯
        System.out.println("Before Controller (Filter)");
        // 放行請(qǐng)求
        chain.doFilter(request, response);
        // 2. 響應(yīng)返回客戶端前的邏輯
        System.out.println("After Controller (Filter)");
    }
    @Override
    public void destroy() {
        // 銷毀邏輯
    }
}

注冊(cè)過濾器（Spring Boot 中）

import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<CustomFilter> customFilter() {
        FilterRegistrationBean<CustomFilter> bean = new FilterRegistrationBean<>();
        bean.setFilter(new CustomFilter());
        bean.addUrlPatterns("/*"); // 攔截所有路徑
        bean.setOrder(1); // 執(zhí)行順序
        return bean;
    }
}

2. 攔截器 (Interceptor) 實(shí)現(xiàn)

攔截器是 Spring MVC 的組件，通過實(shí)現(xiàn) HandlerInterceptor 接口。

步驟：

創(chuàng)建 Interceptor 類

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
@Component
public class CustomInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 在 Controller 方法執(zhí)行前調(diào)用
        System.out.println("Before Controller (Interceptor)");
        return true; // true=放行, false=中斷請(qǐng)求
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, 
                           ModelAndView modelAndView) {
        // 在 Controller 方法執(zhí)行后、視圖渲染前調(diào)用
        System.out.println("After Controller (Interceptor)");
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) {
        // 在整個(gè)請(qǐng)求完成后調(diào)用（視圖渲染完畢）
        System.out.println("After View Render (Interceptor)");
    }
}

注冊(cè)攔截器

import org.springframework.beans.factory.annotation.Autowired;
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 InterceptorConfig implements WebMvcConfigurer {
    @Autowired
    private CustomInterceptor customInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(customInterceptor)
                .addPathPatterns("/**")    // 攔截所有路徑
                .excludePathPatterns("/login"); // 排除路徑
    }
}

執(zhí)行順序示例

假設(shè)請(qǐng)求路徑被過濾器和攔截器同時(shí)攔截：

1. Filter: doFilter() [前邏輯]
2. Interceptor: preHandle()
3. Controller 方法執(zhí)行
4. Interceptor: postHandle()
5. 視圖渲染
6. Interceptor: afterCompletion()
7. Filter: doFilter() [后邏輯]

如何選擇？

場(chǎng)景	推薦使用
全局日志、字符編碼、安全過濾	Filter
權(quán)限驗(yàn)證、參數(shù)預(yù)處理	Interceptor
需要 Spring 容器功能	Interceptor
非 Spring 項(xiàng)目	Filter