Spring拦截器与过滤器：核心差异与应用场景解析-代码聚汇网

Spring拦截器与过滤器：核心差异与应用场景解析

十一爱吃瓜·2026-05-20·阅读 39 GEO检测（免费）

Spring拦截器过滤器Web开发

|难度：普通|阅读约 19 分钟

1. 拦截器与过滤器的本质差异

在Web开发中，拦截器（Interceptor）和过滤器（Filter）是两种经常被混淆的请求处理机制。很多开发者在使用Spring框架时，常常分不清什么时候该用拦截器，什么时候该用过滤器。实际上，它们的定位和功能有着本质的区别。

过滤器是Servlet规范中的一部分，它的工作层级在Servlet容器层面。当请求到达Servlet容器（如Tomcat）时，过滤器是最先接触到请求的组件。它可以对请求和响应进行预处理和后处理，比如字符编码设置、敏感词过滤、权限校验等。过滤器的特点是它的作用范围广，可以过滤所有进入容器的请求，包括静态资源。

而拦截器是Spring MVC框架提供的机制，它的工作层级在DispatcherServlet之后。拦截器只能拦截Controller的请求，对静态资源无效。它更适合处理与业务逻辑相关的横切关注点，比如日志记录、权限校验、性能监控等。

关键区别：过滤器是Servlet容器层面的，拦截器是Spring框架层面的。过滤器能处理所有请求，拦截器只能处理Controller请求。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 工作原理深度解析

2.1 过滤器的工作原理

过滤器的实现基于责任链模式。在web.xml中配置的多个过滤器会形成一个过滤器链。请求会依次通过每个过滤器，每个过滤器都可以决定是否将请求传递给下一个过滤器，或者直接返回响应。

java复制public class MyFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化代码
    }
    
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
        throws IOException, ServletException {
        // 前置处理
        chain.doFilter(request, response); // 传递给下一个过滤器或Servlet
        // 后置处理
    }
    
    @Override
    public void destroy() {
        // 销毁代码
    }
}

过滤器的一个典型应用场景是解决跨域问题。通过在过滤器中设置响应头，可以统一处理所有请求的跨域问题。

2.2 拦截器的工作原理

拦截器是基于Java动态代理实现的。Spring MVC的拦截器需要实现HandlerInterceptor接口，它提供了三个关键方法：

java复制public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // Controller方法执行前调用
        return true; // 返回false则中断执行
    }
    
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
        // Controller方法执行后，视图渲染前调用
    }
    
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        // 整个请求完成后调用
    }
}

拦截器的preHandle方法在Controller方法执行前调用，适合做权限校验；postHandle方法在Controller方法执行后、视图渲染前调用，适合修改ModelAndView；afterCompletion方法在整个请求完成后调用，适合资源清理。

3. 典型应用场景对比

3.1 过滤器的适用场景

字符编码处理：统一设置请求和响应的字符编码
敏感词过滤：对请求参数和响应内容进行敏感词替换
XSS防护：过滤请求中的潜在XSS攻击代码
跨域处理：统一设置CORS相关响应头
请求日志：记录所有进入系统的请求信息
GZIP压缩：对响应内容进行压缩

3.2 拦截器的适用场景

权限校验：检查用户是否有权限访问特定接口
登录验证：验证用户是否已登录
性能监控：记录接口执行时间
参数预处理：统一处理某些参数
接口日志：记录业务接口的调用情况
数据绑定：预处理请求数据

4. 性能与执行顺序分析

4.1 执行顺序对比

一个请求的处理流程中，过滤器和拦截器的执行顺序如下：

过滤器1前置处理
过滤器2前置处理
...
DispatcherServlet
拦截器1preHandle
拦截器2preHandle
Controller方法执行
拦截器2postHandle
拦截器1postHandle
视图渲染
拦截器2afterCompletion
拦截器1afterCompletion
过滤器2后置处理
过滤器1后置处理

4.2 性能考量

过滤器由于工作在Servlet容器层面，它的执行效率通常比拦截器更高。但是拦截器可以获取到Spring的上下文信息，能更方便地使用Spring的各种功能。

在实际项目中，应该根据具体需求选择合适的机制：

如果需要处理所有请求（包括静态资源），或者需要修改请求/响应的内容，应该使用过滤器
如果只需要处理Controller请求，并且需要访问Spring上下文，应该使用拦截器

5. 实际项目中的最佳实践

5.1 过滤器的配置技巧

在Spring Boot中配置过滤器有两种方式：

使用@WebFilter注解：

java复制@WebFilter(urlPatterns = "/*")
public class MyFilter implements Filter {
    // 实现代码
}

使用FilterRegistrationBean：

java复制@Bean
public FilterRegistrationBean<MyFilter> myFilter() {
    FilterRegistrationBean<MyFilter> registration = new FilterRegistrationBean<>();
    registration.setFilter(new MyFilter());
    registration.addUrlPatterns("/*");
    registration.setOrder(1); // 设置执行顺序
    return registration;
}

注意：过滤器的执行顺序很重要，特别是当多个过滤器存在依赖关系时。

5.2 拦截器的配置技巧

在Spring Boot中配置拦截器：

java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyInterceptor())
            .addPathPatterns("/**") // 拦截所有路径
            .excludePathPatterns("/static/**"); // 排除静态资源
    }
}

拦截器的执行顺序可以通过order方法设置：

java复制registry.addInterceptor(new InterceptorA()).order(1);
registry.addInterceptor(new InterceptorB()).order(2);

5.3 常见问题解决方案

问题1：过滤器获取不到Spring Bean

解决方案：使用DelegatingFilterProxy或者将过滤器注册为Spring Bean。

问题2：拦截器对静态资源无效

这不是问题而是特性，如果需要处理静态资源应该使用过滤器。

问题3：拦截器中无法获取方法参数

可以在拦截器中通过HandlerMethod解析handler对象来获取方法信息。

问题4：过滤器中抛出异常

应该在过滤器中妥善处理异常，或者配置错误页面转发。

6. 高级应用场景

6.1 动态拦截器实现

有时候我们需要根据配置动态启用或禁用某些拦截逻辑。可以通过自定义注解和拦截器组合实现：

java复制@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface DynamicCheck {
    String value();
}

public class DynamicInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        if (handler instanceof HandlerMethod) {
            HandlerMethod method = (HandlerMethod)handler;
            DynamicCheck check = method.getMethodAnnotation(DynamicCheck.class);
            if (check != null) {
                // 根据注解值执行动态检查
            }
        }
        return true;
    }
}

6.2 过滤器链的短路处理

在某些情况下，我们可能需要在过滤器中直接返回响应，不再继续执行后续过滤器：

java复制public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
    if (needShortCircuit(request)) {
        // 直接写响应
        response.getWriter().write("Short circuit");
        return;
    }
    chain.doFilter(request, response);
}

6.3 拦截器的异常处理

拦截器中可以统一处理Controller抛出的异常：

java复制public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
    if (ex != null) {
        // 统一异常处理
    }
}

7. 测试与调试技巧

7.1 过滤器的单元测试

测试过滤器可以使用MockHttpServletRequest和MockHttpServletResponse：

java复制@Test
public void testFilter() throws Exception {
    MyFilter filter = new MyFilter();
    MockHttpServletRequest request = new MockHttpServletRequest();
    MockHttpServletResponse response = new MockHttpServletResponse();
    MockFilterChain chain = new MockFilterChain();
    
    filter.doFilter(request, response, chain);
    
    // 验证响应
    assertEquals("UTF-8", response.getCharacterEncoding());
}

7.2 拦截器的单元测试

测试拦截器可以使用MockMvc：

java复制@SpringBootTest
@AutoConfigureMockMvc
public class InterceptorTest {
    @Autowired
    private MockMvc mockMvc;
    
    @Test
    public void testInterceptor() throws Exception {
        mockMvc.perform(get("/api/test"))
            .andExpect(status().isOk())
            .andExpect(header().exists("X-Trace-Id"));
    }
}

7.3 调试技巧

在过滤器和拦截器中添加详细的日志，记录请求和响应信息
使用断点调试时，注意过滤器和拦截器的执行顺序
对于复杂的过滤器链，可以打印FilterChain中的过滤器列表
使用Postman等工具模拟请求，测试不同场景下的行为

8. 性能优化建议

减少不必要的过滤器和拦截器：每个额外的过滤器和拦截器都会增加请求处理时间
优化执行顺序：将最可能阻断请求的过滤器/拦截器放在前面
缓存重复计算：对于频繁使用的数据，考虑在请求范围内缓存
异步处理：对于耗时的操作，考虑使用异步处理避免阻塞请求线程
选择性应用：只为需要的URL模式配置过滤器和拦截器，避免全局应用

在实际项目中，我曾经遇到一个性能问题：系统中有5个全局过滤器和3个拦截器，导致每个请求的处理时间增加了约50ms。通过分析，我们发现其中2个过滤器可以合并，1个拦截器可以改为只在特定路径下生效。优化后，请求处理时间减少了30ms。