当前位置：首页 > news >正文

过滤器和拦截器的区别详解

news 2025/7/4 10:21:08

文章目录

- 过滤器和拦截器的区别详解
- - - 1. 来源不同
    - 2. 触发时机不同
    - 3. 实现原理不同
    - 4. 支持的项目类型不同
    - 5. 使用场景不同
    - 6. 核心区别总结
    - **总结**

过滤器和拦截器的区别详解

在 Web 开发中，过滤器（Filter） 和 拦截器（Interceptor） 是两个常见的机制，用于处理请求和响应的过程。虽然它们的功能有一定的相似性，但在实现原理、触发时机、适用范围等方面存在显著差异。本文将从多个角度详细分析两者的区别。

1. 来源不同

过滤器：属于 Servlet 规范的一部分，依赖于 Servlet 容器。通过实现 javax.servlet.Filter 接口，可以对请求和响应流进行统一管理。它主要服务于 Web 项目。
拦截器：是 Spring 框架中的组件，依赖于 Spring 的核心功能，基于动态代理技术实现。它可以不依赖 Servlet 容器，因此既可用于 Web 项目，也可应用于其他 Java 项目。

2. 触发时机不同

请求的处理流程通常为：
客户端请求 → 容器 → 过滤器 → Servlet → 拦截器 → 控制器（Controller）方法 → 响应

过滤器：
在请求进入 Servlet 之前被触发，用于对请求和响应进行预处理和后续操作。
拦截器：
紧随 Servlet 之后执行，在请求进入控制器方法前或方法后，以及整个请求完成后进行处理。

这种触发顺序使得过滤器更适合处理底层的通用逻辑，而拦截器更贴近业务逻辑。

3. 实现原理不同

过滤器：
基于函数回调机制，通过调用 FilterChain.doFilter() 来控制请求的继续执行。
示例代码如下：

@WebFilter(urlPatterns = "/*")
public class TestFilter implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {System.out.println("过滤器初始化");}@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {System.out.println("请求进入过滤器");chain.doFilter(request, response);System.out.println("响应通过过滤器");}@Overridepublic void destroy() {System.out.println("过滤器销毁");}
}

拦截器：
基于动态代理实现，通过 HandlerInterceptor 接口定义拦截逻辑。拦截器通常需要注册到 Spring 配置中，执行流程包括：

preHandle：请求方法执行前调用，通常用于权限验证。
postHandle：方法执行后调用，但在视图渲染之前。
afterCompletion：整个请求完成后调用，用于资源清理等操作。

示例代码：

@Component
public class TestInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {System.out.println("请求进入拦截器");return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {System.out.println("请求处理完成，视图渲染前");}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {System.out.println("请求完成");}
}

4. 支持的项目类型不同

过滤器：依赖于 Servlet 容器，仅适用于 Web 项目。
拦截器：属于 Spring 的核心功能，既可用于 Web 项目，也可在其他 Java 应用中（如 Swing 或纯 Java 项目）使用。

5. 使用场景不同

由于过滤器和拦截器触发时机和功能上的差异，它们的应用场景也有所不同：

过滤器的常见场景：
- 设置字符编码（如 UTF-8）。
- 过滤敏感词。
- 压缩响应内容（如 Gzip）。
- 日志记录（如记录请求 IP 地址、耗时统计等）。
拦截器的常见场景：
- 用户身份验证。
- 权限校验。
- 业务日志记录。
- 数据格式转换或预处理。

6. 核心区别总结

特性	过滤器（Filter）	拦截器（Interceptor）
来源	Servlet 规范	Spring 框架
触发时机	在请求进入 Servlet 前执行	在请求到达控制器方法前后或完成后执行
实现方式	函数回调机制，需实现 `Filter` 接口	动态代理机制，需实现 `HandlerInterceptor` 接口
适用范围	Web 项目	Web 项目及其他 Java 项目
典型应用场景	字符编码设置、数据压缩等通用功能	用户认证、权限校验等业务逻辑