您现在的位置是：亿华云 > 人工智能

Spring Boot 使用 Filter 的正确姿势！

亿华云2025-10-03 21:59:40【人工智能】4人已围观

简介Filter 是 JavaEE 中 Servlet 规范的一个组件，位于包javax.servlet 中，它可以在 HTTP 请求到达 Servlet 之前，被一个或多个Filter处理。它的工作流程

Filter 是使用势 JavaEE 中 Servlet 规范的一个组件，位于包javax.servlet 中，确姿它可以在 HTTP 请求到达 Servlet 之前，使用势被一个或多个Filter处理。确姿

它的使用势工作流程如图：

Filter的这个特性在生产环境中有很广泛的应用，如：修改请求和响应、确姿防止xss攻击、使用势包装二进制流使其可以多次读，确姿等等。使用势

实际工作中，确姿我们都是使用势使用 SpringBoot 进行业务开发，本文总结三种 Filter 用法，确姿SpringBoot 版本采用目前最新的使用势 v2.3.1.RELEASE

1. 编写Filter

要编写 Filter ，只需要实现javax.servlet.Filter接口就可以了。确姿

public class MyFilter implements Filter { @Override public void doFilter(ServletRequest servletRequest,使用势 ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { System.out.println("MyFilter"); // 要继续处理请求，必须添加 filterChain.doFilter() filterChain.doFilter(servletRequest,servletResponse); } }

Filter 接口有三个方法：init(),doFilter(),destroy()。

其中doFilter()需要自己实现，其余两个是default的，可以不用实现。

Spring Boot 基础就不介绍了，推荐下这个实战教程：https://github.com/javastacks/spring-boot-best-practice

注意：如果Filter要使请求继续被处理，就一定要调用filterChain.doFilter()！

2. 配置Filter被 Spring 管理

让自定义的云服务器 Filter 被 Spring 的 IOC 容器管理，有三种实现方式，各有优缺点。下面课代表给大家总结一下：

（1）使用@Component+@Order

在刚刚定义的MyFilter类上加上@Component和@Order注解，即可被Spring管理

@Component @Order(1) public class MyFilter implements Filter { @Override public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { System.out.println("MyFilter"); // 要继续处理请求，必须添加 filterChain.doFilter() filterChain.doFilter(servletRequest,servletResponse); } }

没错就这么简单，这样 MyFilter 就生效了，写个Controller 调用一下就可以看到效果。

当有多个Filter时，这里的@Order(1)注解会指定执行顺序，数字越小，越优先执行，如果只写@Order，默认顺序值是Integer.MAX_VALUE。

@Component + @Order 注解方式配置简单，支持自定义 Filter 顺序。缺点是只能拦截所有URL，不能通过配置去拦截指定的 URL。

（2）@WebFilter+@ServletComponentScan

在 MyFilter上添加@WebFilter注解，并在启动类上增加@ServletComponentScan("com.zhengxl.filterdemo.filter")注解，参数就是Filter所在的包路径，相当于告诉 SpringBoot，去哪里扫描 Filter

@WebFilter(urlPatterns = "/*") public class MyFilter implements Filter { @Override public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { System.out.println("MyFilter"); // 要继续处理请求，服务器租用必须添加 filterChain.doFilter() filterChain.doFilter(servletRequest,servletResponse); } } @SpringBootApplication @ServletComponentScan("com.zhengxl.filterdemo.filter") public class FilterDemoApplication { public static void main(String[] args) { SpringApplication.run(FilterDemoApplication.class, args); } }

@WebFilter+@ServletComponentScan 注解方式支持对 Filter 匹配指定URL，但是不支持指定 Filter 的执行顺序。

（3）JavaConfig 配置方式

@Configuration public class FilterConfig { @Bean public FilterRegistrationBean registerMyFilter(){ FilterRegistrationBean<MyFilter> bean = new FilterRegistrationBean<>(); bean.setOrder(1); bean.setFilter(new MyFilter()); // 匹配"/hello/"下面的所有url bean.addUrlPatterns("/hello/*"); return bean; } @Bean public FilterRegistrationBean registerMyAnotherFilter(){ FilterRegistrationBean<MyAnotherFilter> bean = new FilterRegistrationBean<>(); bean.setOrder(2); bean.setFilter(new MyAnotherFilter()); // 匹配所有url bean.addUrlPatterns("/*"); return bean; } }

通过 Java 代码显式配置 Filter ，功能强大，配置灵活。只需要把每个自定义的 Filter 声明成 Bean 交给 Spring 管理即可，还可以设置匹配的 URL 、指定 Filter 的先后顺序。