SpringMVC拦截器(Interceptor)与Servlet过滤器(Filter)区别

原创已于 2025-03-10 13:58:47 修改

· 768 阅读

17 ·

版权

文章标签：

#servlet #java #spring boot #spring cloud #spring

于 2025-02-28 03:15:33 首次发布

在Java Web开发中，Spring MVC的拦截器（Interceptor）和Servlet过滤器（Filter）都是用于处理请求和响应的机制，但它们在功能、使用场景和实现方式上有显著的区别。以下是两者的主要区别：

1. 所属框架与层次

拦截器（Interceptor）
- 属于Spring MVC框架的一部分。
- 主要作用于Spring MVC的请求处理流程中，适用于控制层（Controller层）。
- 只对Spring MVC的请求生效，无法拦截非Spring MVC的请求（如静态资源请求或非Spring管理的请求）。
过滤器（Filter）
- 是Servlet规范的一部分，属于Java EE标准。
- 在Web容器（如Tomcat）层面工作，可以拦截所有的HTTP请求和响应。
- 不依赖于任何框架，适用于所有基于Servlet的应用程序。

2. 触发时机

拦截器（Interceptor）
- 在Spring MVC的DispatcherServlet处理请求时触发。
- 可以在Controller方法执行前、后，以及视图渲染完成后进行拦截。
- 通常用于对业务逻辑进行增强，比如权限校验、日志记录等。
过滤器（Filter）
- 在请求到达Servlet之前触发，或者在响应返回客户端之前触发。
- 更接近底层，适合处理一些通用的任务，比如字符编码设置、跨域处理、安全检查等。

3. 配置方式

拦截器（Interceptor）

需要在Spring MVC的配置文件中注册（XML配置）或通过Java配置类注册（WebMvcConfigurer接口）。

示例代码：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyInterceptor())
                .addPathPatterns("/api/**")
                .excludePathPatterns("/api/public");
    }
}

过滤器（Filter）

需要在web.xml中配置，或者通过注解（如@WebFilter）或Spring Boot的FilterRegistrationBean注册。

示例代码：

@WebFilter(urlPatterns = "/api/*")
public class MyFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 前置处理
        chain.doFilter(request, response); // 放行
        // 后置处理
    }
}

4. 拦截范围

拦截器（Interceptor）
- 只能拦截Spring MVC的请求，无法拦截静态资源（如HTML、CSS、JS文件）或其他非Spring管理的请求。
- 可以针对特定的URL路径或Controller方法进行精细化控制。
过滤器（Filter）
- 能够拦截所有进入Web应用的请求，包括静态资源、动态资源以及其他非Spring管理的请求。
- 适用于全局性的任务，比如统一的日志记录、跨域支持等。

5. 依赖注入

拦截器（Interceptor）

是Spring容器管理的组件，因此可以直接使用Spring的依赖注入功能（如@Autowired）。

示例：

public class MyInterceptor implements HandlerInterceptor {
    @Autowired
    private SomeService someService;

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        someService.doSomething();
        return true;
    }
}

过滤器（Filter）
- 默认情况下不是由Spring管理的，因此不能直接使用Spring的依赖注入。
- 如果需要使用Spring的Bean，可以通过ApplicationContext手动获取，或者将过滤器注册为Spring Bean。

6. 执行顺序

拦截器（Interceptor）
- 执行顺序由Spring MVC的DispatcherServlet决定，通常在过滤器之后执行。
- 拦截器的生命周期包括：preHandle（前置处理）、postHandle（后置处理）、afterCompletion（完成处理）。
过滤器（Filter）
- 执行顺序由Web容器决定，通常在拦截器之前执行。
- 过滤器的生命周期包括：init（初始化）、doFilter（过滤逻辑）、destroy（销毁）。

7. 典型应用场景

拦截器（Interceptor）
- 权限校验（如用户登录状态检查）。
- 请求参数预处理（如日志记录、参数校验）。
- 视图渲染后的处理（如修改响应内容）。
过滤器（Filter）
- 字符编码设置（如UTF-8编码）。
- 跨域支持（CORS）。
- 安全防护（如XSS攻击防御、SQL注入防护）。
- 静态资源缓存控制。

总结

特性	拦截器（Interceptor）	过滤器（Filter）
所属框架	Spring MVC	Servlet
触发时机	Spring MVC请求处理过程中	请求到达Servlet之前
拦截范围	仅Spring MVC请求	所有HTTP请求
配置方式	Spring配置类或XML	`web.xml`或`@WebFilter`
依赖注入	支持	默认不支持，需手动处理
典型场景	权限校验、日志记录	字符编码、跨域、安全防护