深度解析：Spring Boot中Filter与Interceptor的执行顺序与优先级

核心结论：Filter的“前处理”最先执行，Interceptor的“前处理”次之；Interceptor的“后处理”先执行，Filter的“后处理”最后执行。 这是一个“Filter外壳包裹Interceptor核心”的模型。

三、Filter执行顺序：@Order与RegistrationBean

在Spring Boot中，定义Filter顺序主要有两种方式：

1. 使用@Order注解或实现Ordered接口：数值越小，优先级越高，在链中越靠前。

@Component 
@Order(1) // 优先级最高，最先执行 
public class LoggingFilter implements Filter { /* ... */ }
@Order(2) // 其次执行
public class AuthFilter implements Filter { /* ... */ }

2. 使用FilterRegistrationBean进行显式、精确控制（推荐）：这种方式更强大、更清晰。

@Configuration 
public class FilterConfig {
    @Bean 
    public FilterRegistrationBean loggingFilter() {
        FilterRegistrationBean reg = new FilterRegistrationBean<>();
        reg.setFilter(new LoggingFilter());
        reg.setOrder(1); // 设置顺序 
        reg.addUrlPatterns("/*");
        return reg;
    }
@Bean 
public FilterRegistrationBean<AuthFilter> authFilter() {
    FilterRegistrationBean<AuthFilter> reg = new FilterRegistrationBean<>();
    reg.setFilter(new AuthFilter());
    reg.setOrder(2); // 在LoggingFilter之后执行 
    reg.addUrlPatterns("/api/*");
    return reg;
}

}

重要提示：如果同时使用@Component和FilterRegistrationBean注册同一个Filter，会导致重复注册和顺序混乱。在鳄鱼java的项目中，我们统一使用FilterRegistrationBean进行注册以确保绝对可控。

四、Interceptor执行顺序：注册顺序即执行顺序

Interceptor的顺序完全由其在WebMvcConfigurer的addInterceptors方法中的注册顺序决定，先注册的先执行。

@Configuration 
public class WebConfig implements WebMvcConfigurer {
    @Override 
    public void addInterceptors(InterceptorRegistry registry) {
        // 1. 最先执行：日志拦截器 
        registry.addInterceptor(new LogInterceptor())
                .addPathPatterns("/**")
                .order(0); // 显式设置order，值越小优先级越高 
    // 2. 其次执行：认证拦截器 
    registry.addInterceptor(new AuthInterceptor())
            .addPathPatterns("/api/**")
            .excludePathPatterns("/api/public/**")
            .order(1);
    
    // 3. 最后执行：性能监控拦截器 
    registry.addInterceptor(new PerformanceInterceptor())
            .addPathPatterns("/api/**")
            .order(2);
}

}

在preHandle阶段，按注册顺序（0->1->2）执行；在postHandle和afterCompletion阶段，则按逆序（2->1->0）执行。这一点常被忽视，导致资源清理或日志记录顺序错误。

五、典型应用场景与配置案例

以一个需要跨域处理、全局日志、JWT认证、API性能监控的RESTful API项目为例，理想的执行顺序配置如下：

1. Filter链配置： - Order(1): CorsFilter：处理CORS预检请求和头部，应位于最外层。 - Order(2): LoggingFilter：记录所有请求/响应的原始信息，需在认证前以记录未认证请求。 - Order(3): CharacterEncodingFilter：设置请求/响应的字符编码。

2. Interceptor链配置： - Order(0): JwtAuthInterceptor：解析JWT token，设置用户上下文。必须在业务Controller之前执行。 - Order(1): PerformanceInterceptor：记录Controller方法执行耗时，需要在认证之后，业务执行之前。

这种配置确保了：CORS最先处理；即使认证失败的请求也被完整日志记录；字符集统一；认证逻辑在Spring上下文中执行，便于依赖注入；性能监控只针对已认证的有效请求。在鳄鱼java为某电商平台设计的微服务网关中，正是采用了这种分层顺序，有效隔离了不同维度的横切关注点。

六、常见陷阱与调试技巧

陷阱1：Filter中抛出异常，Interceptor的afterCompletion不执行
如果Filter在doFilter中抛出异常，请求不会进入DispatcherServlet，因此所有Interceptor的afterCompletion方法都不会被调用。这可能导致资源（如ThreadLocal）无法清理。

陷阱2：Interceptor的preHandle返回false时，哪些方法会执行
当某个Interceptor的preHandle返回false时： - 该Interceptor之前已执行preHandle的其他Interceptor，其afterCompletion会被调用。 - 返回false的Interceptor及其之后的Interceptor，其postHandle和afterCompletion均不会被调用。

调试技巧： 1. 在Filter和Interceptor的每个方法入口打印带顺序标识的日志。 2. 使用Spring Boot Actuator的/actuator/mappings端点查看拦截路径映射。 3. 通过@Order或FilterRegistrationBean的setOrder明确指定顺序，避免依赖自动扫描的不确定性。

七、总结：构建清晰的Web请求处理边界

深入理解Spring Boot Interceptor与Filter执行顺序，本质上是为Web请求处理建立清晰的、分层的架构边界。它要求开发者不仅要实现功能，更要思考每个横切关注点的层次、范围和影响。

在设计和配置时，请系统性地回答以下问题：

1. **这个功能是否需要作用于静态资源或非Spring管理的端点？** 如果是，必须使用Filter。

2. **这个逻辑是否需要访问Spring上下文中的Bean（如Service、数据库事务）？** 如果是，应优先使用Interceptor。

3. **多个同类组件之间的顺序依赖是什么？** 例如，日志Filter是否需要在认证Filter之前，以记录原始请求？

4. **异常处理与资源清理的完整性如何保证？** 尤其是在Filter和Interceptor混合使用的复杂链中。

在鳄鱼java看来，一个优雅、健壮的Web层配置，其Filter和Interceptor的顺序应当像精心编排的乐章，每个部分都在正确的时间点奏响，既不越位，也不缺席。你的请求处理链，是职责清晰、顺序可控的精密仪器，还是随意堆砌、行为难料的混乱组合？这个问题的答案，直接决定了你的应用在面对复杂业务和安全挑战时的可维护性与可靠性。