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 没有“放行”动作,靠返回值控制流程。

BgSub
BgSub

免费的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 值小于 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

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
java
java

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

866

2023.06.15

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

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

745

2023.07.05

java自学难吗
java自学难吗

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

741

2023.07.31

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

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

398

2023.08.01

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

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

420

2023.08.02

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

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

447

2023.08.02

java有什么用
java有什么用

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

431

2023.08.02

java在线网站
java在线网站

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

16947

2023.08.03

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

70

2026.01.23

热门下载

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

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 23.8万人学习

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

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