java拦截器原理是什么

在 Java 生态中，“拦截器（Interceptor）”并不是某一种固定技术，而是一种设计思想和通用机制：在目标方法 / 请求真正执行前后，插入一段通用逻辑，而不修改业务代码本身。

下面从原理本质 → 常见实现方式 → 典型场景三个层面说明。

一、拦截器的核心原理（本质）

拦截器本质 = 代理 + 回调 + 责任链

1. 不直调用业务代码
   • 调用方 → 拦截器 → 目标方法
2. 在关键节点插入逻辑
   • 执行前（pre）
   • 执行后（post）
   • 异常时（error）
3. 决定是否继续执行
   • 放行 / 中断 / 改写结果

二、Java 中拦截器的几种实现原理

1️⃣ 基于「动态代理」的拦截（最底层原理）

典型：Spring AOP、MyBatis 插件

public interface UserService {
    void save();
}

代理过程：

调用者
  ↓
代理对象（Interceptor）
  ↓
真实对象

原理：

• JDK 动态代理（接口）
• CGLIB（子类代理）

✅ 优点：业务无侵入
❌ 只能拦截“可被代理的方法”

2️⃣ 基于「过滤器链 / 责任链」的拦截（Web 层）

典型：Servlet Filter、Spring Interceptor

请求流程：

HTTP 请求
 ↓
Filter
 ↓
Interceptor
 ↓
Controller

✅ 常用于：

• 登录校验
• 日志
• 跨域
• 权限

3️⃣ 基于「框架事件钩子」的拦截

典型：MyBatis Interceptor

@Intercepts({
  @Signature(type=Executor.class, method="update", args={...})
})

原理：

• 框架在关键执行点“留钩子”
• 你实现接口并注册

✅ 精细控制 SQL 执行

4️⃣ 基于「字节码增强」的拦截（高级）

典型：AspectJ、Java Agent

• 编译期 / 类加载期修改字节码
• 可拦截 private、static 方法

✅ 最强能力
❌ 复杂度高

三、一个标准拦截器长什么样？

以 Spring Interceptor 为例：

public class LoginInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(req, res, handler) {
        // 执行前
        return true; // false = 拦截
    }

    @Override
    public void postHandle(...) {
        // 执行后
    }

    @Override
    public void afterCompletion(...) {
        // 最终
    }
}

四、拦截器 vs 过滤器 vs AOP（常混淆）

五、一句话总结

Java 拦截器原理：通过代理或框架钩子，在方法/请求执行前后插入统一逻辑，实现解耦和复用。

如果你指的是某一个具体拦截器（如 Spring、MyBatis、OKHttp、Dubbo），我可以结合源码讲得更细。