当前位置:

首页 > 编程开发 > JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

在Java Web开发中,过滤器Filter和拦截器Interceptor都是实现请求统一预处理、权限校验、日志打印的核心技术。很多开发者容易混淆它们的使用场景和底层机制,今天我们就来彻底理清这两者的区别与联系。 一、过滤器 Filter(Servlet原生技术) 1. 基础介绍 Filter是Se

本文目录

    在Java Web开发中,过滤器Filter和拦截器Interceptor都是实现请求统一预处理、权限校验、日志打印的核心技术。很多开发者容易混淆它们的使用场景和底层机制,今天我们就来彻底理清这两者的区别与联系。

    一、过滤器 Filter(Servlet原生技术)

    1. 基础介绍

    Filter是Servlet规范原生提供的组件,运行在Tomcat等Web服务器层面,可以拦截所有进入容器的资源:静态资源(html、css、图片)、接口Controller、Servlet等全部能拦截。它就像是Web服务器的一道前置关卡,所有请求进来都要先过它这关。

    过滤器有三大生命周期方法:

    1. init():服务器启动时执行,仅执行1次,过滤器初始化;
    2. doFilter():每一次请求都会执行,核心业务逻辑写在此处;
    3. destroy():服务器正常关闭时执行,仅执行1次,资源销毁。

    2. 完整代码实现

    ① 自定义过滤器 DemoFilter

    package org.example.springbootpractice.filter;
    
    import jakarta.servlet.*;
    import jakarta.servlet.annotation.WebFilter;
    import lombok.extern.slf4j.Slf4j;
    
    import java.io.IOException;
    
    @WebFilter(urlPatterns = "/*")
    @Slf4j
    public class DemoFilter implements Filter {
        // 拦截到请求之后,执行,会执行多次
        @Override
        public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
            log.info("doFilter方法运行了,拦截到了请求...");
            // 放行
            chain.doFilter(request, response);
        }
    
        // 初始化方法,会在web服务器启动的时候执行,只会执行一次
        @Override
        public void init(FilterConfig filterConfig) throws ServletException {
            log.info("init初始化方法运行了...");
        }
    
        // 初始化方法,会在web服务器关闭的时候执行,只会执行一次
        @Override
        public void destroy() {
            log.info("destroy销毁方法运行了...");
        }
    }
    

    JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

    ② 启动类开启Servlet组件扫描

    使用@WebFilter注解注册过滤器时,必须在启动类添加@ServletComponentScan,让Spring扫描Filter注解:

    package org.example.springbootpractice;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.boot.web.servlet.ServletComponentScan;
    
    // 扫描项目中@WebFilter、@WebServlet等Servlet注解组件
    @ServletComponentScan
    @SpringBootApplication
    public class SpringbootPracticeApplication {
        public static void main(String[] args) {
            SpringApplication.run(SpringbootPracticeApplication.class, args);
        }
    }
    

    JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

    3. Filter拦截路径匹配规则

    通过@WebFilter(urlPatterns = "xxx")配置拦截范围,下表总结了常见的匹配模式:

    匹配值含义示例
    /login仅拦截指定单一路径只拦截/login接口
    /emps/*目录一级拦截,拦截emps下一级资源匹配/emps/1,不匹配/emps/1/2
    /*拦截项目全部资源(静态资源+所有接口)所有访问都会经过过滤器

    4. 过滤器链(多个Filter执行顺序)

    1. 一个项目可配置多个Filter,多个过滤器串联形成过滤器链;
    2. 注解@WebFilter方式下,执行顺序由类名字典序决定,类名字母靠前先执行;
    3. 执行流程:请求先经过Filter1放行前逻辑 → Filter2放行前逻辑 → Controller处理 → Filter2放行后逻辑 → Filter1放行后逻辑;
    4. 核心放行方法:chain.doFilter(request, response),不调用则直接拦截请求。

    有一个常见疑问:退出登录是否调用destroy()方法?答案是完全无关。destroy()仅服务关闭时执行;退出登录只是前端删除token/后端清除会话,不会触发过滤器销毁。

    二、拦截器 Interceptor(SpringMVC专属技术)

    1. 基础介绍

    Interceptor是SpringMVC框架提供的组件,仅拦截Spring容器内的Controller接口,静态资源(图片、html、js)不会被拦截。它依托Spring IOC容器,可直接注入Service、Mapper等Bean,非常适合做接口权限校验。

    三大核心方法:

    1. preHandle():Controller接口方法执行前触发,返回true放行,false直接阻断请求;
    2. postHandle():Controller执行完成、视图渲染之前触发;
    3. afterCompletion():整个请求全部处理完毕、视图渲染完成后执行,多用于资源释放、日志收尾。

    2. 完整代码实现

    ① 自定义拦截器 DemoInterceptor

    添加@Component交给Spring IOC管理:

    package org.example.springbootpractice.interceptor;
    
    import jakarta.servlet.http.HttpServletRequest;
    import jakarta.servlet.http.HttpServletResponse;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.stereotype.Component;
    import org.springframework.web.servlet.HandlerInterceptor;
    import org.springframework.web.servlet.ModelAndView;
    
    @Slf4j
    @Component
    public class DemoInterceptor implements HandlerInterceptor {
    
        // Controller执行前执行,返回true放行
        @Override
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
            log.info("preHandle...");
            return true;
        }
    
        // Controller执行完成,视图渲染前执行
        @Override
        public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
            log.info("postHandle...");
        }
    
        // 请求全部结束、视图渲染完成后执行
        @Override
        public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
            log.info("afterCompletion...");
        }
    }
    

    JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

    ② WebMvc配置类注册拦截器

    实现WebMvcConfigurer接口,重写addInterceptors注册拦截器,配置拦截/排除路径:

    package org.example.springbootpractice.config;
    
    import org.example.springbootpractice.interceptor.DemoInterceptor;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
    import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
    
    // 标识这是 SpringMVC 配置类,项目启动自动加载
    @Configuration
    public class WebConfig implements WebMvcConfigurer {
    
        // 注入自定义拦截器
        @Autowired
        private DemoInterceptor demoInterceptor;
    
        @Override
        public void addInterceptors(InterceptorRegistry registry) {
            registry.addInterceptor(demoInterceptor)
                    // 拦截所有请求接口
                    .addPathPatterns("/**");
            // 可选:排除不需要拦截的路径,示例
            // .excludePathPatterns("/login", "/static/**", "/error");
        }
    }
    

    JavaWeb过滤器Filter和拦截器Interceptor到底有什么区别?

    3. Interceptor路径匹配规则

    配置addPathPatterns/excludePathPatterns设置拦截、放行路径,注意与Filter的/*不同,拦截器常用/**匹配多级路径:

    匹配值含义示例
    /*仅匹配一级路径匹配/emps、/login;不匹配/emps/1
    /**匹配任意多级路径(开发常用)匹配/emps、/emps/1、/emps/1/2
    /depts/*匹配depts下一级接口匹配/depts/1;不匹配/depts/1/2
    /depts/**匹配depts下所有层级接口匹配/depts、/depts/1、/depts/1/2

    三、Filter与Interceptor完整执行顺序

    请求完整生命周期流程如下:

    浏览器请求 → Web服务器 → Filter放行前逻辑 → SpringMVC分发器 → Interceptor.preHandle → Controller执行业务 → Interceptor.postHandle → 视图渲染 → Interceptor.afterCompletion → Filter放行后逻辑 → 浏览器接收响应

    这个顺序决定了Filter比Interceptor更早介入请求,也更晚退出。Filter在Tomcat层面拦截,Interceptor在SpringMVC内部拦截。

    四、过滤器与拦截器核心区别

    底层规范不同

    • Filter:Servlet原生接口,实现Filter;
    • Interceptor:SpringMVC框架接口,实现HandlerInterceptor。

    拦截范围不同

    • Filter:Tomcat层面,拦截全部资源(静态资源+接口+Servlet);
    • Interceptor:SpringMVC层面,仅拦截Controller接口,静态资源不拦截。

    容器依赖不同

    • Filter:属于Servlet容器,无法直接使用Spring IOC注入Bean;
    • Interceptor:归Spring IOC管理,可直接@Autowired注入Service、Mapper。

    执行时机不同

    • Filter:在请求进入Spring容器之前执行;
    • Interceptor:请求进入Spring容器、到达Controller之前执行。

    使用场景区分

    • Filter:全局统一编码、跨域处理、静态资源过滤、Token全局校验;
    • Interceptor:接口登录权限校验、接口操作日志、Controller入参预处理。

    拓展实战:Token登录认证过滤器流程(登录校验业务)

    项目登录认证统一校验,一般使用Filter实现全局Token拦截,流程如下:

    1. 获取当前请求URL;
    2. 判断URL是否包含/login登录路径,若是直接放行;
    3. 从请求头中提取token令牌;
    4. 无token直接返回401未认证状态码;
    5. 解析token,解析失败(过期/篡改)同样返回401;
    6. 校验通过,放行请求访问业务接口。

    核心业务逻辑伪代码:

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        HttpServletResponse resp = (HttpServletResponse) response;
        String url = req.getRequestURI();
        // 登录接口直接放行
        if(url.contains("/login")){
            chain.doFilter(request, response);
            return;
        }
        // 获取token
        String token = req.getHeader("token");
        if(token == null || token.isEmpty()){
            resp.setStatus(401);
            return;
        }
        try{
            // 解析token
            JwtUtil.parseToken(token);
            // 校验通过放行
            chain.doFilter(request, response);
        }catch (Exception e){
            // token失效/篡改,返回401
            resp.setStatus(401);
        }
    }
    

    五、总结

    1. 简单区分:全局所有资源拦截用Filter,仅Controller接口权限控制用Interceptor;
    2. 路径匹配:拦截器匹配所有多级接口务必写/**,过滤器拦截全部资源写/*;
    3. 生命周期:Filter的destroy()仅服务关闭触发,和登录退出无关联;
    4. 开发规范:登录Token认证、跨域、编码统一推荐Filter;接口细粒度权限、操作日志推荐Interceptor。

    希望这篇文章能帮你彻底理清Filter和Interceptor的区别,在实际开发中做出更合适的技术选型。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务
    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务

    Decider v1.3面向细致判断,Flash v1.3面向高量路由与过滤;locate抽取原文片段及位置,需与分类、多模态和托管入口限制分开理解。

    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?
    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?

    5.23.0影响范围取决于旧导出对象、音频依赖与专家并行路径,新增模型也有实验和变体限制。

    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?
    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?

    Copilot停用旧模型不等于自动迁移;区分移除、组织模型启用、工作流切换与个人年订阅例外。

    GitHub Actions重跑失败作业会使用最新代码吗
    GitHub Actions重跑失败作业会使用最新代码吗

    解释已有运行重跑的提交和权限边界,给出确认、失败作业重跑及结果核对命令,区分漏触发事件。

    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界
    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界

    chat-demo v0.1.1可以作为静态聊天客户端在本地运行,但模型、搜索、文件和语音能力仍由DeepSeek API提供。源码运行环境为Node.js 22.12及以上、Git与pnpm。Demo版本号不等于应用API版本;这套应用API未单独标版本,默认聊天模型ID是deepseek-flash。

    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解
    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解

    理解GitHub Copilot CLI v1.0.111的高级请求百分比、用户提示活动图与实际路由模型窗口,区分显示口径和任务状态。

    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?
    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?

    按维护分支、利用权限与节点类型对应四项修复,区分正式补丁、Beta和临时缓解的适用边界。

    GitHub合并故障的已缓解、监控与已解决有什么不同
    GitHub合并故障的已缓解、监控与已解决有什么不同

    GitHub合并故障中的“已缓解并监控”和“已解决”不能互换。前者表示影响已经采取措施缓解,仍在观察稳定性;后者是供应商正式结束这场事故的状态。11月13日的Pull Requests合并超时事件先进入监控,随后于北京时间11月14日02:29标记为已解决。

    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景
    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景

    llama.cpp v1.0.0改善聊天组织、长消息编辑和附件预览;界面变化与底层API迁移、缓存及访问边界需要分别理解。

    Postman 12.36.4 更新后仍报错,怎么判断是哪一层的问题
    Postman 12.36.4 更新后仍报错,怎么判断是哪一层的问题

    Postman 12.36.4 更新后仍有异常时,可按应用、API请求和平台服务区分问题范围,避免把补丁版本当作故障原因。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。