← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第29章 设计模式 23 讲 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

29.11 代理模式:Spring 魔法的总开关

审校 2026-09-25 · 素材来源:itstack-demo-design 复盘、深度文49
📑 本篇章节导航 (共8节,点击直达)
三种代理:静态、JDK 动态、CGLIB代理的四大用途:一张记忆网框架现场:一个模式的半壁江山代理失效清单(面试实战区)$Proxy 的验尸报告:断点里看清代理真身自注入与 AopContext:绕过 this 坑的两条工程出路面试怎么问一句话总结

结构型收官一讲,也是最重量级的一讲:代理模式(控制对目标对象的访问,在调用前后插入额外逻辑)。如果说其他模式是「认识」,代理是「信仰」——Spring 的 AOP、事务、懒加载、MyBatis 的 Mapper、RPC 的消费端、AI 应用的护栏,全建立在它之上。27.2 手写过 AOP 织入,这一讲把代理本身讲透。

三种代理:静态、JDK 动态、CGLIB

静态代理:手写一个类实现同接口、持有目标、方法内前后加料——和装饰器结构一模一样(意图区分见 29.8)。缺点明显:接口加方法代理要跟着改,一百个接口写一百个代理类。JDK 动态代理:运行时生成代理类,一个 InvocationHandler 处理所有方法:


UserService proxy = (UserService) Proxy.newProxyInstance(
    loader,
    new Class[]{UserService.class},
    (p, method, args) -> {            // 所有调用汇聚到这
      log.before(method.getName());
      try {
        Object result = method.invoke(target, args);
        log.success(method.getName());
        return result;
      } catch (Throwable e) {
        log.fail(method.getName(), e);
        throw e;
      }
    });

限制:只能代理接口(Proxy.newProxyInstance 第二个参数是接口列表)——没有接口的类无门。CGLIB 动态代理:生成目标类的子类,覆写非 final 方法织入拦截(MethodInterceptor)——不需要接口,但 final 类与方法无法代理。Spring 的选择逻辑(13.2 讲过):有接口默认 JDK 代理(Boot 2.x 起默认 CGLIB),可全局配置;事务、AOP 都吃这条规则——「为什么这个 Bean 的 @Transactional 没生效」一半的答案是代理类型或被 final 挡了。

代理的四大用途:一张记忆网

远程代理:本地调远程——27.4 手写 RPC 的消费端、16.3 OpenFeign、12.3 的 Stub,全是远程代理:代理在本地收调用,翻译成网络请求。虚拟代理:延迟创建重对象——图片先占位加载时再真造、Spring 的 lazy-init Bean、getBean 时才走完整创建流程(27.1 的懒加载)。保护代理:权限检查——18 章鉴权、26.3 MCP 网关的调用方校验,先验身份再放行。智能引用代理:附加管理逻辑——事务开启提交(13.3)、缓存(15.2 一级缓存)、计数与日志、25.3 工具调用的审计。四大用途一张网:远程管距离、虚拟管时机、保护管权限、智能管增强。

框架现场:一个模式的半壁江山

Spring AOP:AnnotationAwareAspectJAutoProxyCreator(一个 BPP,27.2 手写过它的迷你版)在初始化后给匹配 Bean 返回代理——事务、缓存注解、异步注解、全局异常的底层全是代理。MyBatis Mapper:15.2 讲过 getMapper 返回 JDK 动态代理,接口没有实现类,「实现」是代理里的「按命名空间找 SQL 执行」。RPC 消费端(27.4):ReferenceBean 注入的即远程代理。AI 应用护栏:26.3 的 MCP 网关对工具调用的鉴权审计、22.2 的输入过滤,本质是「给模型的能力调用加代理层」——代理模式在 AI 时代的身份:模型与工具之间的安检门。

代理失效清单(面试实战区)

代理生效有个前提:调用必须经过代理对象。失效场景全是「绕过了代理」:this 内部调用(27.2 重点讲过——this 是目标不是代理);final 方法(CGLIB 覆写不了);private 方法(外部不可达代理更不可达);构造器里调用被代理方法(对象还没代理完);@Autowired 注入具体类而代理是 CGLIB 子类(类型不匹配的边角)。排查思路一句话:打个断点看 this 的实际类型是不是 $$Proxy 或 $$EnhancerBySpringCGLIB——是则调用会走增强,否则必失效。

$Proxy 的验尸报告:断点里看清代理真身

「代理失效怎么排查」的最高效动作是给代理类做一次「验尸」:在调用处打断点看 this 的实际类型——JDK 代理显示 com.sun.proxy.$Proxy37,CGLIB 显示 UserService$$EnhancerBySpringCGLIB$$8a3f2e1(类名里直接写着 Enhancer 与一串哈希)。再往下看一层更精彩:JDK 代理类反编译后是「一个构造器吃 InvocationHandler、每个方法都 invoke(handler, this, args) 转发」的机械代码——没有任何业务痕迹,代理类只是「把所有调用打包送给 handler」的收发室;CGLIB 则能看到方法体里先 MethodInterceptor.intercept 再 decide 是否放行 super 调用。做一次这个实验(Arthas 的 jad 或 IDEA 的 Evaluate Class Files 都行),代理从概念变成眼见为实——面试说「我断点看过 $Proxy 的反编译」,比背十条特性更有说服力。

自注入与 AopContext:绕过 this 坑的两条工程出路

this 内部调用绕代理是高频事故(27.2 讲成因),工程上两条正路值得记。自注入:类里 @Autowired private UserService self;,内部调用改走 self.otherMethod()——注入的 self 是代理,增强恢复生效;代价是「自己注入自己」的别扭观感与潜在的循环依赖敏感(setter/字段注入可解,13.2 的账)。AopContext:@EnableAspectJAutoProxy(exposeProxy = true) 开启后,((UserService) AopContext.currentProxy()).otherMethod() 显式取当前代理——框架味更浓,ThreadLocal 存代理引用(7.7 的机制第三次客串)。两条路的共同思想:凡是要走增强的调用,引用必须拿到代理而非 this。更干净的重构其实是把内部调用拆出去(拆到另一个 Bean),让容器替你保证「跨 Bean 调用必经代理」——三个方案按「拆方法→自注入→AopContext」的顺序选,越靠前越不脏。最后记一个代理与生命周期交叉的坑:BPP 织入发生在初始化之后(27.2),所以 @PostConstruct 里 this 拿到的必然是原生对象——构造与初始化阶段对外的引用不经过代理,这个时序在排查「初始化里调事务方法没生效」时就是答案。

面试怎么问

一句话总结

代理模式是「在调用必经之路上设卡」的艺术:Spring 用它织 AOP、MyBatis 用它造接口幻觉、RPC 用它抹平距离、AI 平台用它当模型的安检门——看懂代理,Java 框架的魔法就拆穿了一半。