0

0

Java过滤器和拦截器的区别和使用场景_Filter与Interceptor功能对比及适用情况

月夜之吻

月夜之吻

发布时间:2026-01-11 13:17:48

|

207人浏览过

|

来源于php中文网

原创

Filter是Servlet规范组件,作用于容器层,用于请求响应拦截;Interceptor是Spring MVC组件,作用于HandlerMapping后,依赖Spring上下文,用于Controller前后处理。

java过滤器和拦截器的区别和使用场景_filter与interceptor功能对比及适用情况

Filter 是 Servlet 规范的一部分,作用在容器层面

Filter 在请求进入 Servlet 容器(如 Tomcat)后、到达 Servlet 之前执行,也能在响应返回客户端前拦截。它不依赖 Spring,只要配置在 web.xml 或用 @WebFilter 注解就能生效。

常见使用场景包括:统一字符编码设置、日志记录、跨域头添加、静态资源过滤、敏感词过滤等。

容易踩的坑:

  • Filter 对 HttpServletRequestHttpServletResponse 的包装类(如 HttpServletRequestWrapper)需手动继承并重写方法才能修改请求/响应体,否则无法篡改 body 内容
  • Filter 无法直接获取 Spring 管理的 Bean(除非通过 WebApplicationContextUtils 手动获取上下文)
  • 多个 Filter 的执行顺序由 @Orderweb.xml 中声明顺序决定,但不支持基于路径的细粒度控制

Interceptor 是 Spring MVC 的组件,作用在 HandlerMapping 之后、Controller 执行前后

Interceptor 运行在 Spring MVC 的调度流程中,本质是 HandlerInterceptor 接口的实现类,必须注册到 WebMvcConfigureraddInterceptors() 方法中才生效。

立即学习Java免费学习笔记(深入)”;

典型用途有:登录状态校验、权限检查、接口耗时统计、参数预处理(如自动注入用户信息)、全局异常前的日志埋点。

行者AI
行者AI

行者AI绘图创作,唤醒新的灵感,创造更多可能

下载

关键限制与注意点:

  • 只对进入 Spring MVC 流程的请求有效(即匹配到 Controller 的请求),静态资源、错误页(如 404)、Filter 已拦截返回的响应,都不会触发 Interceptor
  • 可以轻松注入其他 Spring Bean(如 UserServiceRedisTemplate),天然支持依赖注入
  • 三个核心方法:preHandle()(返回 false 可中断流程)、postHandle()(Controller 执行完、视图渲染前)、afterCompletion()(整个请求结束,包括异常处理后)

Filter 和 Interceptor 同时存在时的执行顺序

一个 HTTP 请求的完整链路中,它们的调用顺序是固定的:

Filter#doFilter → Interceptor#preHandle → Controller → Interceptor#postHandle → View Render → Interceptor#afterCompletion → Filter#doFilter (response phase)

这意味着:

  • 若某个 Filter 调用了 chain.doFilter() 后又修改了 response body,Interceptor 的 afterCompletion() 仍能感知到最终响应状态码,但看不到 body 修改过程
  • preHandle() 返回 false,Controller 不会执行,但已进入的 Filter 仍会走完自己的 doFilter() 后半段(即响应阶段)
  • 异常发生时,Filter 的 doFilter() 会收到 ServletExceptionIOException;而 Interceptor 的 afterCompletion() 第三个参数 Throwable 才能捕获 Controller 层抛出的业务异常

该用哪个?看你的需求是否需要 Spring 上下文和 MVC 生命周期钩子

判断依据很简单:

  • 要改请求/响应的原始字节流(如 GZIP 压缩、加解密)、或控制非 Spring MVC 资源(如 /favicon.ico/actuator/health),选 Filter
  • 要读取 @RequestBody 解析后的对象、调用 @Service 方法做权限判断、或依赖 ModelAndView 做视图增强,必须用 Interceptor
  • 想做全链路 traceId 透传?Filter 更底层可靠;但若 traceId 存在 ThreadLocal 里且需在 Service 层复用,Interceptor + RequestContextHolder 更方便

二者不是互斥关系,生产环境常共存:Filter 做基础设施层拦截(如 CORS、UTF-8 强制设置),Interceptor 做业务层横切逻辑(如租户隔离、操作审计)。真正容易被忽略的是——Filter 拿不到 Controller 方法签名,Interceptor 拿不到原始 input stream,各自的能力边界比文档写的更硬。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

831

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

396

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

79

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.4万人学习

C# 教程
C# 教程

共94课时 | 6.5万人学习

Java 教程
Java 教程

共578课时 | 44.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号