一、什么是拦截器？一句话看懂

拦截器 = “请求/方法” 的横切逻辑植入器：
让你不改业务代码，就能在目标执行前后统一加戏——鉴权、日志、限流、事务、国际化 … 统统安排。

二、三大实现方式一张表看懂

一句话记忆：
请求级用 HandlerInterceptor， 方法级用 AOP， 底层通用用 Filter。

三、SpringMVC 拦截器 5 分钟落地

1. 实现接口

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest req,
                             HttpServletResponse resp,
                             Object handler) {
        // 1. 前置逻辑：鉴权、参数校验、日志...
        return true;          // true 继续；false 中断
    }
    @Override
    public void postHandle(...)  { /* 2. Controller 后、渲染前 */ }
    @Override
    public void afterCompletion(...) { /* 3. 全部完成 */ }
}

2.注册

@Configuration
public class WebConfig implements WebMvcConfigurer {
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyInterceptor())
                .addPathPatterns("/api/**")
                .excludePathPatterns("/login");
    }
}

3.执行顺序
preHandle 正序 → Controller → postHandle 逆序 → 渲染 → afterCompletion 逆序
（先注册的先执行前置，后执行后置）

四、2025 最新玩法（Lambda、响应式、原生镜像）

1.Lambda 式注册（Spring Boot 3.2+）
不再需要 @Configuration：

@Bean
public InterceptorRegistrationFunction myInterceptor() {
    return registry -> registry
            .addInterceptor((req, resp, h) -> { /* 逻辑 */ })
            .addPathPatterns("/api/**");
}

2.响应式 WebFilter（Spring 6 + WebFlux）

@Component
public class ReactiveAuthFilter implements WebFilter {
    public Mono<Void> filter(ServerWebExchange exchange, WebFilterChain chain) {
        return chain.filter(exchange)
                    .contextWrite(ctx -> ctx.put("tenantId", parseTenant(exchange)));
    }
}

3.GraalVM Native 友好
native-image 禁止反射，必须显式声明：

@RegisterReflection({MyInterceptor.class})
public class MyInterceptor implements HandlerInterceptor {}

编译后体积 50 MB，启动 0.05 s。

五、进阶骚操作

六、一张脑图带走

Java 拦截器 2025
├─ 传统三剑客（Filter/HandlerInterceptor/AOP）
├─ 最新实现
│  ├─ Lambda 注册（Boot 3.2+）
│  ├─ Reactive WebFilter（Spring 6）
│  └─ GraalVM 原生
└─ 黑科技
   ├─ 热插拔 & TTL 多租户
   ├─ 内存限流 & 差分响应
   └─ 请求火焰图

七、最佳实践口诀

1. 拦截器链能少就少，IO/DB 耗时操作异步化。
2. preHandle 返回 false 时，一定自己回写 JSON，否则空白响应。
3. 高优拦截器靠前注册；用 @Order 控制顺序。
4. 生产加开关 + 熔断，防止拦截器故障拖垮全站。
5. 复杂业务（事务、缓存）交给 AOP，让拦截器保持简洁。

八、结语

从 JSP 时代的 Filter，到 Spring MVC 的 HandlerInterceptor，再到 2025 的 Lambda 注册、响应式、GraalVM 原生，拦截器技术栈已全面进化。