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免费学习笔记(深入)”;

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

Genspark
Genspark

Genspark 是一款创新的 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,各自的能力边界比文档写的更硬。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

117

2023.10.26

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

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

171

2024.02.23

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

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

98

2024.02.23

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

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

169

2024.02.23

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

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

157

2024.02.23

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

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

200

2024.02.23

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

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

243

2024.02.23

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

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

167

2024.02.23

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

24

2026.02.28

热门下载

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

精品课程

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

共23课时 | 4万人学习

C# 教程
C# 教程

共94课时 | 10.5万人学习

Java 教程
Java 教程

共578课时 | 74.9万人学习

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

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