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

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

发布时间 - 2026-01-26 00:00:00 点击率：次

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

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() 获取上下文
Interceptor 的 preHandle 方法返回 false 会中断执行链，但不会阻止 Filter 的 doFilter 后续调用
多个 Filter 按 web.xml 或 @WebFilter 的 order 值顺序执行；多个 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 没有“放行”动作，靠返回值控制流程。

如何在 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.xml 中 ContextLoaderListener 的值小于 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 流程里。

# css # java # js # 处理器 # 编码 # app # tomcat # 栈 # ai # 跨域 # 区别 # 性能瓶颈 # spring mvc # red

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：VSCode如何实现代码版本对比 VSCode Git差异对

下一篇：VSCode极速配置Scala：sbt支持、中文文档、REP

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：VSCode如何实现代码版本对比 VSCode Git差异对

下一篇：VSCode极速配置Scala：sbt支持、中文文档、REP