Spring中过滤器和拦截器的区别及具体实现方式

 更新时间:2025年07月10日 09:45:35   作者:邓不利东  
在Spring框架中,和都是用于处理 HTTP 请求的中间件,但它们在作用范围、实现方式和生命周期上有显著区别,本文给大家介绍Spring中过滤器和拦截器的区别及具体实现,感兴趣的朋友一起看看吧

在 Spring 框架中,过滤器(Filter)拦截器(Interceptor) 都是用于处理 HTTP 请求的中间件,但它们在作用范围、实现方式和生命周期上有显著区别。以下是详细对比和实现方式:

核心区别

特性过滤器 (Filter)拦截器 (Interceptor)
规范Servlet 规范 (J2EE 标准)Spring 框架特有
作用范围所有 Web 资源(Servlet、JSP、静态资源)仅 Spring MVC 管理的 Controller 请求
依赖依赖 Servlet 容器(如 Tomcat)依赖 Spring 容器
拦截时机在请求进入 Servlet 前 / 响应发送到客户端前在请求进入 Controller 前 / 后 / 视图渲染后
获取 Spring Bean不能直接获取(需通过工具类)可直接获取 Spring Bean
异常处理无法使用 Spring 的异常处理机制可结合 @ControllerAdvice 统一异常处理

实现方式

1. 过滤器 (Filter) 实现

过滤器是 Servlet 规范的一部分,通过实现 javax.servlet.Filter 接口实现。

步骤:

  1. 创建 Filter 类
import javax.servlet.*;
import java.io.IOException;
public class CustomFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) {
        // 初始化逻辑
    }
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
        throws IOException, ServletException {
        // 1. 请求到达 Controller 前的逻辑
        System.out.println("Before Controller (Filter)");
        // 放行请求
        chain.doFilter(request, response);
        // 2. 响应返回客户端前的逻辑
        System.out.println("After Controller (Filter)");
    }
    @Override
    public void destroy() {
        // 销毁逻辑
    }
}
  1. 注册过滤器(Spring Boot 中)
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<CustomFilter> customFilter() {
        FilterRegistrationBean<CustomFilter> bean = new FilterRegistrationBean<>();
        bean.setFilter(new CustomFilter());
        bean.addUrlPatterns("/*"); // 拦截所有路径
        bean.setOrder(1); // 执行顺序
        return bean;
    }
}

2. 拦截器 (Interceptor) 实现

拦截器是 Spring MVC 的组件,通过实现 HandlerInterceptor 接口。

步骤:

  1. 创建 Interceptor 类
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
@Component
public class CustomInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 在 Controller 方法执行前调用
        System.out.println("Before Controller (Interceptor)");
        return true; // true=放行, false=中断请求
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, 
                           ModelAndView modelAndView) {
        // 在 Controller 方法执行后、视图渲染前调用
        System.out.println("After Controller (Interceptor)");
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) {
        // 在整个请求完成后调用(视图渲染完毕)
        System.out.println("After View Render (Interceptor)");
    }
}
  1. 注册拦截器
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;
@Configuration
public class InterceptorConfig implements WebMvcConfigurer {
    @Autowired
    private CustomInterceptor customInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(customInterceptor)
                .addPathPatterns("/**")    // 拦截所有路径
                .excludePathPatterns("/login"); // 排除路径
    }
}

执行顺序示例

假设请求路径被过滤器和拦截器同时拦截:

1. Filter: doFilter() [前逻辑]
2. Interceptor: preHandle()
3. Controller 方法执行
4. Interceptor: postHandle()
5. 视图渲染
6. Interceptor: afterCompletion()
7. Filter: doFilter() [后逻辑]

如何选择?

场景推荐使用
全局日志、字符编码、安全过滤Filter
权限验证、参数预处理Interceptor
需要 Spring 容器功能Interceptor
非 Spring 项目Filter

最佳实践:优先使用 Interceptor(可集成 Spring 特性),若需处理静态资源或深度请求/响应修改,则用 Filter。

到此这篇关于Spring中过滤器和拦截器的区别及具体实现的文章就介绍到这了,更多相关Spring过滤器和拦截器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Maven的porfile与SpringBoot的profile结合使用案例详解

    Maven的porfile与SpringBoot的profile结合使用案例详解

    这篇文章主要介绍了Maven的porfile与SpringBoot的profile结合使用,通过maven的profile功能,在打包的时候,通过-P指定maven激活某个pofile,这个profile里面配置了一个参数activatedProperties,不同的profile里面的这个参数的值不同,需要的朋友可以参考下吧
    2021-12-12
  • Spring security 自定义过滤器实现Json参数传递并兼容表单参数(实例代码)

    Spring security 自定义过滤器实现Json参数传递并兼容表单参数(实例代码)

    这篇文章主要介绍了Spring security 自定义过滤器实现Json参数传递并兼容表单参数,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-01-01
  • JavaScript的基本类型值-String类型

    JavaScript的基本类型值-String类型

    String类型用于表示由零或多个16位Unicode字符组成的字符序列,即字符串。在JavaScript中没有单个的字符型,都是字符串。这篇文章主要介绍了JavaScript的基本类型值String类型,需要的朋友可以参考下
    2017-02-02
  • Sentinel初始化启动流程详细介绍

    Sentinel初始化启动流程详细介绍

    Sentinel是一个分布式系统的流量控制组件,它可以实现限流与流控及降级等功能,提高系统的稳定性和可靠性,这篇文章主要介绍了Sentinel的初始化流程,感兴趣想要详细了解可以参考下文
    2023-05-05
  • Java使用Tesseract-Ocr识别数字

    Java使用Tesseract-Ocr识别数字

    这篇文章主要介绍了Java使用Tesseract-Ocr识别数字的方法,帮助大家更好的理解和学习使用Java,感兴趣的朋友可以了解下
    2021-04-04
  • SpringBoot整合Freemarker的基本步骤

    SpringBoot整合Freemarker的基本步骤

    这篇文章主要介绍了SpringBoot整合Freemarker的基本步骤,添加依赖及添加相关配置的实例代码详解,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-02-02
  • Java中获取文件大小的详解及实例代码

    Java中获取文件大小的详解及实例代码

    这篇文章主要介绍了Java中获取文件大小的详解及实例代码的相关资料,一种是使用File的length()方法,另外一种是使用FileInputStream的available()方法,这里就说下如何使用需要的朋友可以参考下
    2016-12-12
  • Java从配置文件中获取参数的三种常见场景和完整示例

    Java从配置文件中获取参数的三种常见场景和完整示例

    在 Java 中从配置文件获取参数是开发中的常见需求,不同配置文件格式和框架有不同的实现方式,以下是 最常用的 3 种场景+完整示例,覆盖原生 Java 和 Spring Boot 项目,直接复用即可,需要的朋友可以参考下
    2026-01-01
  • MybatisPlus实现多表的关联查询,实现分页,多条件查询全过程

    MybatisPlus实现多表的关联查询,实现分页,多条件查询全过程

    文章介绍了如何通过商品表与供应商表的关联查询,实现商品信息的模糊查询,具体包括建立DAO层接口、实体类和请求参数类,编写SQL查询语句,以及在控制层处理查询请求
    2026-03-03
  • Java行为型设计模式之外观设计模式详解

    Java行为型设计模式之外观设计模式详解

    外观模式为多个复杂的子系统,提供了一个一致的界面,使得调用端只和这个接口发生调用,而无须关系这个子系统内部的细节。本文将通过示例详细为大家讲解一下外观模式,需要的可以参考一下
    2022-11-11

最新评论