0

0

Java过滤器和拦截器_Filter和Interceptor技术综合对比

星降

星降

发布时间:2026-01-26 12:33:48

|

197人浏览过

|

来源于php中文网

原创

Filter由Servlet容器管理,作用于所有请求;Interceptor由Spring管理,仅拦截DispatcherServlet处理的请求。Filter更底层通用,Interceptor可访问Spring Bean和Controller上下文。

java过滤器和拦截器_filter和interceptor技术综合对比

Filter 是 Servlet 规范的一部分,Interceptor 属于 Spring 框架层

Filter 在容器启动时由 Servlet 容器(如 Tomcat)加载,作用于所有请求,包括静态资源;Interceptor 是 Spring MVC 的组件,仅对进入 DispatcherServlet 的请求生效,不拦截 .js、.css 等静态文件。

这意味着:如果你要统一处理跨域、字符编码、日志记录等底层 HTTP 请求/响应操作,Filter 更底层、更通用;若需访问 Spring 容器中的 Bean(比如 UserService)、或依赖 Controller 方法参数/返回值(如注解校验、权限判断),必须用 Interceptor

  • Filter 无法直接获取 Spring 管理的 Bean,除非手动从 WebApplicationContextUtils.getRequiredWebApplicationContext() 获取上下文
  • InterceptorpreHandle 方法返回 false 会中断执行链,但不会阻止 Filter 的 doFilter 后续调用
  • 多个 Filter 按 web.xml@WebFilterorder 值顺序执行;多个 Interceptor 按 addInterceptor() 注册顺序执行

生命周期和执行时机差异明显

Filter 的生命周期由容器管理:init()doFilter()(可多次)→ destroy();Interceptor 实例由 Spring 创建,其三个方法对应请求处理的不同阶段:

  • preHandle():Controller 方法执行前,可做权限检查、日志打点。返回 false 则后续不执行
  • postHandle():Controller 方法已执行、视图渲染前,可修改 ModelAndView
  • afterCompletion():整个请求完成(包括视图渲染),可用于资源清理、异常统计

注意:postHandle 不会在异常发生时调用,而 afterCompletion 会,并可通过第三个参数 Exception ex 判断是否出错。

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

Filter 的 doFilter 必须显式调用 chain.doFilter(request, response) 才能放行,漏写会导致请求卡死;Interceptor 没有“放行”动作,靠返回值控制流程。

Rose.ai
Rose.ai

一个云数据平台,帮助用户发现、可视化数据

下载

如何在 Filter 中获取 Spring Bean?

Filter 初始化早于 Spring 上下文,不能直接注入 Bean。常用做法是通过 ServletContext 拿到根应用上下文:

public class AuthFilter implements Filter {
    private UserService userService;

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        ServletContext context = filterConfig.getServletContext();
        WebApplicationContext webAppCtx = 
            WebApplicationContextUtils.getWebApplicationContext(context);
        this.userService = webAppCtx.getBean(UserService.class);
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse res,
                         FilterChain chain) throws IOException, ServletException {
        // 使用 this.userService...
        chain.doFilter(req, res);
    }
}

但要注意:这种方式要求 ContextLoaderListener 已注册(即 Spring 根上下文已启动),且该 Filter 不能声明为 @Component(否则 Spring 会尝试管理它,造成初始化冲突)。

  • 推荐将需要 Bean 的逻辑下沉到 Service 层,Filter 只做轻量解析(如提取 token)后交由 Interceptor 或 Controller 处理
  • 若坚持在 Filter 里用 Bean,务必确认 web.xmlContextLoaderListener<load-on-startup> 值小于 Filter 的加载顺序

性能与调试常见陷阱

Filter 和 Interceptor 都可能成为性能瓶颈,尤其在日志记录或加密解密场景中。关键区别在于:Filter 对所有请求生效,Interceptor 只对 MVC 请求生效——所以一个未配置静态资源排除的 Filter,可能被千万次 CSS 请求反复触发。

  • Filter 中避免耗时操作(如远程调用、DB 查询),因其运行在容器线程中,阻塞直接影响吞吐量
  • Interceptor 的 postHandle 无法修改响应体(HttpServletResponse.getWriter() 已关闭),想改响应内容得用 Filter 或 ResponseBodyAdvice
  • 使用 Spring Boot 时,@Bean 注册的 Filter 默认不生效,需加 @ServletComponentScan 或用 FilterRegistrationBean 显式注册
  • Filter 和 Interceptor 都可能被重复注册(如自动扫描 + 手动注册),导致逻辑执行两次,建议在日志中加入唯一标识排查

最常被忽略的一点:Filter 的 doFilter 如果抛出异常,容器会直接返回 500,而 Interceptor 的异常会被 Spring 的异常处理器捕获——这意味着你可能在 Filter 里看到空指针却找不到堆,因为异常没走到 Spring 的 @ControllerAdvice 流程里。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的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服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

173

2024.02.23

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

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

99

2024.02.23

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

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

170

2024.02.23

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

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

158

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、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

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

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

169

2024.02.23

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

25

2026.03.13

热门下载

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

精品课程

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

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.8万人学习

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

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