0

0

Java过滤器和拦截器的区别是什么_Filter与Interceptor核心差异解析

幻夢星雲

幻夢星雲

发布时间:2026-01-11 15:47:11

|

942人浏览过

|

来源于php中文网

原创

Filter 先于 Interceptor 执行,顺序为 Filter → DispatcherServlet → Interceptor → Controller;Filter 处理原始 Servlet 请求,Interceptor 可注入 Spring Bean 并操作 MVC 组件。

java过滤器和拦截器的区别是什么_filter与interceptor核心差异解析

Filter 和 Interceptor 谁先执行?顺序不能搞错

过滤器(Filter)一定在拦截器(HandlerInterceptor)之前执行,而且是「外层包内层」的关系:请求路径上依次是 Filter → DispatcherServlet → Interceptor → Controller。这意味着:
Filter.doFilter() 里调用 chain.doFilter() 之前,你只能拿到原始的 ServletRequest/ServletResponse,拿不到 Spring 的 HttpServletRequest 或任何 IOC Bean;
Interceptor.preHandle() 已经能注入 @Service@Repository 等 Bean,也能访问 ModelAndView 和控制器参数;
• 如果你在 Filter 中修改了请求体(比如解密 payload),但没重置 request.getInputStream(),后续 @RequestBody 可能读到空内容——这是高频翻车点。

什么时候必须用 Filter,而不是 Interceptor?

当你需要处理以下场景时,Filter 是唯一选择:
• 拦截静态资源(/js/app.js/images/logo.png),因为 Interceptor 根本不生效;
• 强制设置字符编码(如 request.setCharacterEncoding("UTF-8")),必须在进入 DispatcherServlet 前完成,否则 @RequestParam 中文会乱码;
• 全局 CORS 头添加(response.setHeader("Access-Control-Allow-Origin", "*")),尤其在未启用 Spring WebMvc 的跨域配置时;
• 请求体预处理(如 AES 解密、gzip 解压),因为 Interceptor 拿不到原始字节流,也无法替换 HttpServletRequestWrapper

Interceptor 能做而 Filter 做不了的关键能力

HandlerInterceptor 的核心优势在于「深度集成 Spring 生态」:
• 可以直接 @Autowired 任意 Spring Bean(比如 UserServiceRedisTemplate),Filter 里只能靠 WebApplicationContextUtils.getRequiredWebApplicationContext() 手动捞,且需确保上下文已初始化;
postHandle() 能修改 ModelAndView,比如统一加 footer 数据;
afterCompletion() 可捕获 Controller 抛出的异常,做日志或监控埋点,而 FilterdoFilter() 后续无法感知业务异常;
• 支持按路径精确匹配(如 "/api/**"),也支持排除特定后缀("/api/**.html"),Filter@WebFilter(urlPatterns = "/*") 只能粗粒度控制。

注册方式和生命周期差异直接影响调试体验

两者的注册机制决定了你查问题时该看哪块日志:
Filter 由 Servlet 容器(Tomcat/Jetty)管理:启动时调用 init() 一次,销毁时调用 destroy() 一次,所有请求共用同一个实例——所以它必须是线程安全的,不能在字段存 request-scoped 数据;
Interceptor 由 Spring IoC 容器管理:可以是 prototype 作用域,也可以是 singleton;preHandle() 每次请求都新建帧,天然隔离;
• 注册方式也不同:Filter 用 @WebFilterFilterRegistrationBean,Interceptor 必须通过 WebMvcConfigurer.addInterceptors() 注册;
• 错误表现差异明显:如果 Filter.init() 抛异常,应用直接启动失败;而 Interceptor.preHandle() 返回 false 只会让当前请求 404 或 403,不影响其他请求。

FreeTTS
FreeTTS

FreeTTS是一个免费开源的在线文本到语音生成解决方案,可以将文本转换成MP3,

下载

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

真正容易被忽略的是:Filter 修改了 response 内容(比如压缩或加水印)后,必须确保没有提前 commit response(即没调用 response.getOutputStream().flush()),否则 Interceptor 的 afterCompletion() 还没执行,响应就发出去了——这种时序问题在压测时才暴露,但日志里根本看不出因果。

相关专题

更多
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++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

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号