SpringBoot设置过滤器（Filter）或拦截器（Interceptor）的执行顺序：@Order注解、setOrder()方法

原创 已于 2025-03-10 19:45:29 修改 · 1k 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring boot #java #后端

于 2025-03-10 18:44:34 首次发布
最低0.47元/天 解锁文章
Spring Boot - filter 的顺序
学无止境
11-19 1650
Bean@Bean正常访问：http://localhost:8080/hello不正常访问：http://localhost:8080/HELLO可看到路径mapping是区分大小写的，如果路径不正确，虽然404，但过滤器链依然会执行（/*全局情况下）。
SpringBoot 拦截器：从基础原理到高级实战的应用指南与技巧解析
本博客聚焦 YOLOv11 全流程落地，涵盖架构优化、数据集处理、训练技巧与多场景部署，兼及国产数据库、Java 开发与 AI 模型应用，内容兼顾理论与工程实践，为开发者提供系统干货，助力高效提升技术能力。
05-26 1545
拦截器是Spring MVC框架中的一种机制，用于在请求处理的不同阶段进行拦截和处理。它类似于Servlet中的过滤器，但提供了更精细的控制和更丰富的功能。拦截器的主要方法包括preHandle（在Controller方法执行前调用）、postHandle（在Controller方法执行后，视图渲染前调用）和afterCompletion（在整个请求完成后调用）。拦截器可以用于权限验证、日志记录、参数预处理、修改模型数据、资源清理等场景。与过滤器相比，拦截器更依赖于Spring容器，能够直接获取Spring
SpringBoot自定义过滤器的两种方式及过滤器执行顺序
Mozart97的博客
12-10 2902
SpringBoot自定义过滤器的两种方式及过滤器执行顺序 转载 https://www.cnblogs.com/ibigboy/p/11528775.html 第一种 @WebFilter + @ServletComponentScan 注解 1、首先自定义过滤器 如下自定义过滤器 ReqResFilter 必须实现 javax.servlet.Filter。 然后添加注解 @WebFilter（javax.servlet.annotation.WebFilter），urlPatterns 过滤器要过滤
sprigboot中过滤器执行顺序源码解读
weixin_43401380的博客
07-18 4309
本文主要是搞清楚对于同一请求在springboot项目中自定义的filter和jar包中的filter的执行顺序是如何指定的。首先从请求出发,考虑请求在到达自定义controller之前都是进过了哪些过滤器。直接进入主题，所有的请求访问时都会经过一个个过滤器，方法返回的时候会按照过滤器的顺序从后面往前之前执行，专业术语叫过滤器链，就好比，你从一楼爬到五楼，一定是从五楼顺着走回一楼，请求也是如此。请求发送过来，涉及到过滤器执行的重要方法是，里面定义了过滤器的执行顺序所以从上面可以看到请求发送过来，是按照...
Filter | Filter顺序设置
苏老师的博客
06-20 3379
Filter顺序设置
SpringBoot自定义Filter的顺序
dongyan3595的博客
10-10 2360
SpringBoot自定义Filter的顺序
SpringBoot -拦截器Interceptor、过滤器 Filter 及设置
web13093320398的博客
01-21 862
/ 设置过滤器的执行顺序，数字越小越先执行。1 .灵活性高，它允许过滤器成为 Spring 的 Bean，从而可以利用 Spring 的各种功能，来注册它，使其能够与 Spring 应用上下文集成。2 .便与维护和管理。有多个过滤器需要集成和管理。1**.创建一个过滤器：MyFilter**注解用于指定过滤器要拦截的 URL 模式，上述代码中，addInterceptor。假设我们有一个自定义的过滤器。表示拦截所有的请求路径。
Spring Boot 开发 -- 过滤器与拦截器详解
dazhong2012的专栏
06-01 1221
在Spring boot中，我们需要FilterRegistrationBean来完成配置。@Bean@Override@Override@Override这里直接用@WebFilter就可以进行配置，同样，可以设置url匹配模式，过滤器名称等。这里需要注意一点的是**@WebFilter这个注解是Servlet3.0的规范**，并不是Spring boot提供的。，指定扫描的包。
Spring Boot 之 Filter顺序配置 @Order无效原因解读（源码理解）
ieen_csdn的博客
01-23 2万+
Spring Filter类结构图 implementsimplementsextendsextendsCompositeFilterFilterGenericFilterBeanDelegatingFilterProxyOncePerRequestFilter extendsextendsextendsextendsextendsextendsCharacterEncodingFilterOnc...
关于@webFilter使用@Order无效问题
weixin_34364071的博客
08-26 492
2019独角兽企业重金招聘Python工程师标准>>> ...
springboot顺序执行多个Filter
weixin_40631204的博客
07-19 2900
这是第一个filter @Component public class FirstFilter implements Filter { @Override public void init(FilterConfig filterConfig) throws ServletException { } @Override public void do...
Springboot 中各个filter如何调整执行顺序（通过@Order，Ordered，FilterRegistrationBean三种方式）
热门推荐
fajing_feiyue的博客
12-15 2万+
我们在使用filter不可避免的会用到过滤器，在还未使用springboot的的项目的时候，都是讲过滤器配置在web.xml中。配置的越靠前，filter越先执行。现在很多都是用@WebFilter注解，看到下面注解源码，并没有参数指定顺序。 @Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented pu...
SpringBoot：过滤器：过滤器讲解（1）
q736317048的博客
11-29 242
SpringBoot2.X过滤器讲解 什么是过滤器 filter简单理解：人—>检票员（filter）—> 景点 SpringBoot2.X里面的过滤器 ApplicationContextHeaderFilter OrderedCharacterEncodingFilter OrderedFormContentFilter OrderedRequestContextFilter 那么多过滤器，哪个优先级高呢？ Ordered.HIGHEST_PRECEDENCE Ordere
SpringBoot使用Filter
zjhblog的博客
04-20 915
Filter 是 JavaEE 中 Servlet 规范的一个组件，位于包javax.servlet 中，它可以在 HTTP 请求到达 Servlet 之前，被一个或多个Filter处理。 1.案例结构 1.1first拦截器 @WebFilter(filterName = "first" , urlPatterns = "/*") @Order(1) public class FirstFilter implements Filter { @Override public void init
第八节 SpringBoot使用过滤器与拦截器
大宇的博客，欢迎访问
11-20 1101
一、过滤器Filter 创建过滤器的方法很简单，也传统的WEB项目一样，实现 Filter接口即可 package com.zhoutianyu.learnspringboot.filter; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import javax.servlet.*; import ja...
Spring Boot 使用 Filter 的正确姿势！
2401_83412172的博客
05-02 1188
互联网大厂比较喜欢的人才特点：对技术有热情，强硬的技术基础实力；主动，善于团队协作，善于总结思考。无论是哪家公司，都很重视高并发高可用技术，重视基础，所以千万别小看任何知识。面试是一个双向选择的过程，不要抱着畏惧的心态去面试，不利于自己的发挥。同时看中的应该不止薪资，还要看你是不是真的喜欢这家公司，是不是能真的得到锻炼。其实我写了这么多，只是我自己的总结，并不一定适用于所有人，相信经过一些面试，大家都会有这些感触。下面有部分截图希望能对大家有所帮助。
SpringBoot 中使用 Filter 的正确姿势
田维常
11-16 247
Filter 是 JavaEE 中 Servlet 规范的一个组件，位于包javax.servlet 中，它可以在 HTTP 请求到达 Servlet 之前，被一个或多个Filter处理。...
过滤器和拦截器的执行顺序如何调试或自定义？
最新发布
10-14
<think>我们正在讨论Spring Boot中过滤器与拦截器的执行顺序问题。根据引用材料，我们知道过滤器和拦截器在请求处理流程中的位置不同，且可能存在多个过滤器和拦截器，因此需要调整它们的执行顺序。 关键点： 1. 过滤器(Filter)位于Servlet容器层面，在请求进入Servlet之前执行，响应发送到客户端之前也会执行（在拦截器之后）。 2. 拦截器(Interceptor)位于Spring MVC层面，在DispatcherServlet之后执行，在Controller方法执行前后以及视图渲染前后插入逻辑。 执行顺序： 请求流程：过滤器(Filter) -> DispatcherServlet -> 拦截器(Interceptor) -> Controller 响应流程：Controller -> 拦截器(Interceptor) -> DispatcherServlet -> 过滤器(Filter) 因此，过滤器的执行顺序在拦截器之前（请求阶段），在拦截器之后（响应阶段）。 但是，当有多个过滤器或多个拦截器时，我们需要控制它们的执行顺序。 一、过滤器的执行顺序控制 根据引用[1]和[3]： 1. 使用FilterRegistrationBean注册过滤器时，可以通过setOrder方法设置顺序（数值越小，优先级越高）。 2. 使用@Order注解：在Filter类上使用@Order注解（注意：需要配合FilterRegistrationBean或使用@Component让Spring管理，但直接使用@Component注册的Filter顺序不可控，所以推荐使用FilterRegistrationBean）。 示例代码： ```java @Configuration public class FilterConfig { @Bean public FilterRegistrationBean<FilterA> filterA() { FilterRegistrationBean<FilterA> bean = new FilterRegistrationBean<>(new FilterA()); bean.addUrlPatterns("/*"); bean.setOrder(1); // 数值越小，执行顺序越靠前 return bean; } @Bean public FilterRegistrationBean<FilterB> filterB() { FilterRegistrationBean<FilterB> bean = new FilterRegistrationBean<>(new FilterB()); bean.addUrlPatterns("/*"); bean.setOrder(2); // 在FilterA之后执行 return bean; } } ``` 二、拦截器的执行顺序控制 根据引用[2]： 在实现WebMvcConfigurer的addInterceptors方法中，按照注册拦截器的顺序决定执行顺序（先注册的先执行）。但是注意，拦截器内部有preHandle、postHandle、afterCompletion方法，它们的执行顺序如下： 1. preHandle方法：按注册顺序执行。 2. postHandle方法：按注册顺序的逆序执行。 3. afterCompletion方法：按注册顺序的逆序执行。 示例代码： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new InterceptorA()).addPathPatterns("/**").order(1); // 数值越小，preHandle执行越靠前 registry.addInterceptor(new InterceptorB()).addPathPatterns("/**").order(2); // 在InterceptorA之后执行（preHandle） // 注意：order方法可以设置顺序，如果不设置，则按照添加的顺序（即代码中的顺序）执行，相当于order(0)，但数值从小到大执行（即order值小的先执行） } } ``` 注意：拦截器的order方法设置的值也是数值越小优先级越高（即执行越靠前）。如果不设置order，则默认按照添加顺序，且默认值为0。 三、过滤器与拦截器混合时的执行顺序 根据引用[3]和[4]，当同时存在过滤器和拦截器时，整个执行流程如下： 请求阶段： Filter1（order最小） -> Filter2 -> ... -> DispatcherServlet -> Interceptor1（order最小）的preHandle -> Interceptor2的preHandle -> ... -> Controller 响应阶段： Controller方法执行完毕 -> Interceptor2的postHandle（如果preHandle返回true） -> Interceptor1的postHandle -> ... -> 视图渲染 -> Interceptor2的afterCompletion -> Interceptor1的afterCompletion -> ... -> DispatcherServlet -> Filter2的doFilter后续代码 -> Filter1的doFilter后续代码 四、调试技巧 1. 在过滤器和拦截器的关键方法中打印日志，注意记录执行时间和顺序。 2. 使用断点调试： - 在过滤器的doFilter方法中打断点。 - 在拦截器的preHandle、postHandle、afterCompletion方法中打断点。 3. 注意：由于过滤器在Servlet容器层面，而拦截器在Spring MVC层面，所以调试时要注意两者的执行位置。 五、自定义执行顺序的注意事项 1. 过滤器顺序：通过FilterRegistrationBean的setOrder方法或@Order注解（但要注意，使用@Component和@Order时，需要确保过滤器是通过FilterRegistrationBean注册的，或者使用ServletComponentScan扫描，但顺序控制不如FilterRegistrationBean灵活）。 2. 拦截器顺序：通过InterceptorRegistry的order方法设置，数值越小优先级越高。 3. 混合顺序：过滤器的执行总是在拦截器之前（请求阶段）和之后（响应阶段），无法改变这个相对顺序。所以如果有必须在拦截器之前执行的逻辑（如请求体的读取），则放在过滤器中；如果逻辑需要访问Spring上下文（如依赖注入的Bean），则放在拦截器中。 六、常见问题解决 1. 如果过滤器需要依赖Spring容器中的Bean，可以使用以下方法： - 使用FilterRegistrationBean注册过滤器，并在Filter中通过SpringContextUtil获取Bean（因为过滤器不是由Spring管理的，所以不能直接注入）。 - 让过滤器实现Spring的ApplicationContextAware接口，或者使用DelegatingFilterProxy（Spring Security中常用）。 2. 在过滤器中修改请求体（如读取输入流）可能会导致拦截器或Controller中无法再次读取，需要谨慎处理。 七、与Spring Security整合时的顺序 根据引用[3]和[4]，Spring Security本身就是一系列过滤器链。自定义过滤器和拦截器需要特别注意与Spring Security过滤器链的顺序。 1. 自定义过滤器：可以通过@Order注解或FilterRegistrationBean设置顺序，但要考虑是在Security过滤器链之前还是之后执行。 2. 自定义拦截器：不受Security影响，因为拦截器在DispatcherServlet之后，而Security过滤器在DispatcherServlet之前。 示例：将自定义过滤器插入到Spring Security过滤器链中 参考引用[3]：我们可以使用HttpSecurity的addFilterBefore、addFilterAfter等方法。 总结： - 过滤器顺序：通过FilterRegistrationBean的setOrder方法控制，数值小的先执行。 - 拦截器顺序：通过InterceptorRegistry的order方法控制，数值小的preHandle先执行。 - 过滤器与拦截器的相对顺序是固定的：过滤器（请求处理）-> 拦截器 -> 控制器 -> 拦截器（响应处理）-> 过滤器（响应处理）。 通过以上方法，可以灵活调整过滤器和拦截器的执行顺序，满足复杂业务的需求。 </think>### Spring Boot 中调试与自定义过滤器/拦截器执行顺序的方法 #### 一、理解执行顺序机制 在 Spring Boot 请求处理流程中，**过滤器和拦截器执行顺序固定**： ``` 请求 → 过滤器(Filter Chain) → DispatcherServlet → 拦截器(Interceptor) → Controller 响应 → 拦截器(Interceptor) → DispatcherServlet → 过滤器(Filter Chain) → 客户端 ``` 这个基础顺序无法改变[^1][^3]，但组件的内部顺序可通过以下方式调整： --- #### 二、过滤器(Filter)顺序控制 1. **使用 `FilterRegistrationBean` 注册**（推荐） ```java @Configuration public class FilterConfig { @Bean public FilterRegistrationBean<FilterA> filterA() { FilterRegistrationBean<FilterA> bean = new FilterRegistrationBean<>(); bean.setFilter(new FilterA()); bean.addUrlPatterns("/*"); bean.setOrder(1); // 数值越小优先级越高 return bean; } @Bean public FilterRegistrationBean<FilterB> filterB() { FilterRegistrationBean<FilterB> bean = new FilterRegistrationBean<>(); bean.setFilter(new FilterB()); bean.addUrlPatterns("/*"); bean.setOrder(2); // 在 FilterA 后执行 return bean; } } ``` 2. **使用 `@Order` 注解**（需配合过滤器链） ```java @Component @Order(1) // 定义执行优先级 public class CustomFilter extends OncePerRequestFilter { @Override protected void doFilterInternal(...) { // 过滤逻辑 chain.doFilter(request, response); } } ``` --- #### 三、拦截器(Interceptor)顺序控制 通过 `InterceptorRegistry` 设置执行顺序： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new AuthInterceptor()) .addPathPatterns("/**") .order(1); // 数值越小越先执行 registry.addInterceptor(new LogInterceptor()) .addPathPatterns("/**") .order(2); // 在 AuthInterceptor 后执行 } } ``` --- #### 四、混合调试技巧 当过滤器和拦截器共存时： 1. **日志标记法** ```java // 在过滤器和拦截器中添加标识日志 public void doFilter(...) { log.info(">>> FilterA START"); chain.doFilter(request, response); log.info("<<< FilterA END"); } // 拦截器 public boolean preHandle(...) { log.info("--> Interceptor PRE"); return true; } ``` 2. **断点调试优先级** - 过滤器断点：设置在 `doFilter()` 方法首行 - 拦截器断点：设置在 `preHandle()` 方法首行 - 观察调用栈中的执行顺序差异[^1] 3. **顺序冲突解决** ```mermaid graph LR A[Filter Order=1] --> B[Filter Order=2] B --> C[Interceptor Order=1] C --> D[Interceptor Order=2] D --> E[Controller] ``` --- #### 五、特殊场景处理 1. **与 Spring Security 整合** ```java @Configuration @EnableWebSecurity public class SecurityConfig { @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.addFilterBefore( new CustomFilter(), UsernamePasswordAuthenticationFilter.class // 指定插入位置 ); return http.build(); } } ``` Security 过滤器链默认在普通过滤器之后执行[^3] 2. **与 Shiro 整合** 使用 `ShiroFilterFactoryBean` 明确指定过滤器顺序： ```java @Bean public ShiroFilterFactoryBean shiroFilter() { ShiroFilterFactoryBean bean = new ShiroFilterFactoryBean(); LinkedHashMap<String, Filter> filters = new LinkedHashMap<>(); filters.put("custom", new CustomShiroFilter()); // 按添加顺序执行 bean.setFilters(filters); return bean; } ``` --- #### 六、最佳实践建议 1. **优先使用拦截器**处理业务验证（如登录检查），因其天然集成 Spring 生态[^2] 2. **过滤器更适合**处理底层操作（如编码转换、请求包装） 3. 调试时重点关注： - 过滤器的 `order` 值（数值越小越优先） - 拦截器的注册顺序（先注册先执行） - Spring Security/Shiro 的特殊过滤器链机制[^3][^4] > 通过合理设置执行顺序和日志跟踪，可有效管理复杂请求处理流程[^1][^2][^3]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

pan_junbiao

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值