讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

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

浅辰酱_2506

浅辰酱_2506

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

|

982人浏览过

|

来源于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(比如 UserService、RedisTemplate),Filter 里只能靠 WebApplicationContextUtils.getRequiredWebApplicationContext() 手动捞,且需确保上下文已初始化;
• postHandle() 能修改 ModelAndView,比如统一加 footer 数据;
• afterCompletion() 可捕获 Controller 抛出的异常,做日志或监控埋点,而 Filter 的 doFilter() 后续无法感知业务异常;
• 支持按路径精确匹配(如 "/api/**"),也支持排除特定后缀("/api/**.html"),Filter 的 @WebFilter(urlPatterns = "/*") 只能粗粒度控制。

JavaScript 测试模式
JavaScript 测试模式

使用 Jest、Vitest 和 Testing Library 实施全面的测试策略,包括单元测试、集成测试和端到端测试,涵盖模拟、测试夹具和测试驱动开发。在编

下载

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

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

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

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

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

965

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

324

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

509

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

305

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

348

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

349

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

322

2024.02.23

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn