SpringBoot实现过滤器(Filter)三种常用方式
更新时间：2026年06月16日 09:31:46 作者：码不停蹄的玄黓
这篇文章主要介绍了三种在JavaWeb项目中实现过滤器（Filter）的方式,包括注解方式、FilterRegistrationBean注册方式以及@Component方式,并附上执行顺序和常见实战场景示例,适用于不同需求的项目开发,需要的朋友可以参考下
Filter 是 Java Web 原生组件，优先级早于 Interceptor，可拦截所有请求，下面分三种主流实现方式，附完整代码、配置、执行顺序。
一、前置说明
- 过滤器基于
javax.servlet.Filter（Servlet 规范） - Spring Boot 无需手动配置
web.xml，注解/注册 Bean 即可生效 - 执行顺序：
Filter → DispatcherServlet → Interceptor → Controller
方式一：注解方式（最简，推荐简单场景）
使用 @WebFilter + 启动类开启 Servlet 注解扫描，零配置。
1. 编写自定义过滤器
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
// 拦截所有请求 /*
@WebFilter(filterName = "MyFilter", urlPatterns = "/*")
public class MyFilter implements Filter {
// 初始化（容器启动执行一次）
@Override
public void init(FilterConfig filterConfig) throws ServletException {
System.out.println("过滤器初始化");
}
// 核心拦截逻辑（每次请求都会执行）
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) request;
HttpServletResponse resp = (HttpServletResponse) response;
// 放行前逻辑（前置处理）
System.out.println("请求地址：" + req.getRequestURI());
// 放行，执行后续过滤器/接口
chain.doFilter(request, response);
// 放行后逻辑（后置处理，响应返回客户端前）
System.out.println("请求结束");
}
// 销毁（容器关闭执行一次）
@Override
public void destroy() {
System.out.println("过滤器销毁");
}
}
2. 启动类开启注解支持
启动类添加 @ServletComponentScan，扫描 @WebFilter：
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;
@SpringBootApplication
@ServletComponentScan // 关键注解：扫描 Servlet、Filter、Listener
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
优缺点
- ✅ 简单快捷，适合单过滤器、简单项目
- ❌ 无法手动指定多个过滤器执行顺序
方式二：注册 FilterRegistrationBean（推荐，可控制顺序）
Spring Boot 官方推荐方式，支持排序、指定拦截路径、禁用原生注解，多过滤器首选。
1. 先写过滤器（普通 Java 类，不加 @WebFilter）
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
public class OrderFilter1 implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
System.out.println("【过滤器1】执行");
chain.doFilter(request, response);
System.out.println("【过滤器1】结束");
}
@Override
public void init(FilterConfig filterConfig) {}
@Override
public void destroy() {}
}
public class OrderFilter2 implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
System.out.println("【过滤器2】执行");
chain.doFilter(request, response);
System.out.println("【过滤器2】结束");
}
@Override
public void init(FilterConfig filterConfig) {}
@Override
public void destroy() {}
}
2. 编写配置类，注册过滤器 + 排序
order 值越小，优先级越高，越先执行。
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<OrderFilter1> filter1() {
FilterRegistrationBean<OrderFilter1> bean = new FilterRegistrationBean<>();
bean.setFilter(new OrderFilter1());
bean.addUrlPatterns("/*"); // 拦截路径
bean.setOrder(1); // 执行顺序：1 > 2
return bean;
}
@Bean
public FilterRegistrationBean<OrderFilter2> filter2() {
FilterRegistrationBean<OrderFilter2> bean = new FilterRegistrationBean<>();
bean.setFilter(new OrderFilter2());
bean.addUrlPatterns("/*");
bean.setOrder(2); // 顺序靠后
return bean;
}
}
执行顺序
请求进来：Filter1 → Filter2 → 接口 → Filter2后置 → Filter1后置
常用配置扩展
// 排除指定路径
bean.addInitParameter("exclusions", "/login,/static/*");
// 设置过滤器名称
bean.setName("customFilter");
方式三：直接将 Filter 交给 Spring 容器（简单排序）
直接在 Filter 上加 @Component，Spring 自动注册为过滤器。
代码示例
import org.springframework.stereotype.Component;
import javax.servlet.*;
import java.io.IOException;
@Component
public class BeanFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
System.out.println("Spring Bean 过滤器执行");
chain.doFilter(request, response);
}
@Override
public void init(FilterConfig filterConfig) {}
@Override
public void destroy() {}
}
控制顺序
配合 @Order(数值)，数值越小越先执行：
@Component
@Order(0)
public class BeanFilter1 implements Filter { ... }
@Component
@Order(1)
public class BeanFilter2 implements Filter { ... }
优缺点
- ✅ 写法简洁
- ❌ 部分场景路径配置不如
FilterRegistrationBean灵活
四、常见实战场景示例（跨域、编码）
统一编码过滤器
@Component
public class EncodingFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
request.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");
chain.doFilter(request, response);
}
}
简单跨域过滤器
@Component
public class CorsFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletResponse resp = (HttpServletResponse) response;
resp.setHeader("Access-Control-Allow-Origin", "*");
resp.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE");
resp.setHeader("Access-Control-Max-Age", "3600");
resp.setHeader("Access-Control-Allow-Headers", "*");
chain.doFilter(request, response);
}
}
五、三种方式总结 & 选型建议
- 简单单过滤器：用
@WebFilter + @ServletComponentScan - 多过滤器、需要严格排序/精细路径配置：优先
FilterRegistrationBean（企业常用） - 快速开发、简单排序：
@Component + @Order
注意：Filter 无法获取 Spring MVC 的 Controller 方法信息，如需拦截接口、获取注解/方法参数，改用 Interceptor 拦截器。
以上就是SpringBoot实现过滤器(Filter)三种常用方式的详细内容，更多关于SpringBoot过滤器(Filter)实现方式的资料请关注脚本之家其它相关文章！
相关文章
当响应的瓶颈在数据库的时候,就要考虑数据库的读写分离,当然还可以分库分表,那是单表数据量特别大,当单表数据量不是特别大,但是请求量比较大的时候,就要考虑读写分离了.具体的话,还是要看自己的业务...如果还是很慢,那就要分库分表了...我们这篇就简单讲一下读写分离2022-05-05
把spring boot项目发布tomcat容器（包含发布到tomcat6的方法）
这篇文章主要介绍了把spring boot项目发布tomcat容器（包含发布到tomcat6的方法），然后在文章给大家提到了如何将Spring Boot项目打包部署到外部Tomcat，需要的朋友参考下吧2017-11-11
Java开发中,导出Excel是常见需求,有时需要支持多个Sheet导出,此技巧介绍非模板方式实现单标题单Sheet以及多Sheet导出,标题一致或不一致均可,可换成Map使用,适合个人开发者和需要Excel导出功能的场景2024-09-09
对于互联网来说，只要你系统的接口会暴露在外网，就避免不了接口安全问题。 如果你的接口在外网裸奔，只要让黑客知道接口的地址和参数就可以调用，那简直就是灾难。这篇文章主要介绍了SpringBoot保证接口安全的方法，需要的可以参考一下2023-02-02
这篇文章主要介绍了最全面的JVM优化经验总结,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，,需要的朋友可以参考下2019-06-06
这篇文章主要介绍了使用javafx更新UI的方法，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-07-07
SpringBoot Actuator未授权访问漏洞修复详解
这篇文章主要介绍了SpringBoot Actuator未授权访问漏洞修复详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-08-08
这篇文章主要介绍了mybatis开启spring事务代码解析，具有一定参考价值，需要的朋友可以了解下。2017-12-12
这篇文章主要介绍了详解SpringBoot启动类的扫描注解的用法及冲突原则，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-11-11
本文主要介绍了Jenkins+Git+Maven自动化部署配置详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-01-01
最新评论