java Proxy 代理为何失效

在 Java 中，Proxy（动态代理）失效是一个常见问题，通常不是 Proxy 本身有 bug，而是使用方式或场景不满足动态代理的前提条件。下面按最常见原因 → 原理 → 解决办法来说明。

一、最常见原因汇总（先给结论）

二、JDK 动态代理的核心限制（最重要）

✅ 只能代理「接口」

interface Service {
    void hello();
}

class ServiceImpl implements Service {
    public void hello() {}
}

✅ 正确：

Service proxy = (Service) Proxy.newProxyInstance(
    classLoader,
    new Class[]{Service.class},
    handler
);

❌ 错误（会直接失败）：

Proxy.newProxyInstance(
    classLoader,
    new Class[]{ServiceImpl.class}, // 类不行
    handler
);

如果你要代理类 → 用 CGLIB / ByteBuddy

三、this 调用导致代理失效（非常常见）

示例代码

public class ServiceImpl implements Service {
    public void a() {
        b(); // this.b()
    }

    public void b() {}
}

即使你代理了 Service：

proxy.a();

b() 不会走代理！

原因

• proxy.a() → 进入 InvocationHandler
• a() 内部调用的是 this.b()
• this 是 真实对象，不是代理对象

解决方式

1. 拆成两个 Bean（Spring 推荐）
2. 自己注入自己（小心循环依赖）
3. 使用 AopContext.currentProxy()（Spring）

((Service) AopContext.currentProxy()).b();

四、final / static / private 方法无法代理

public final void test() {} // ❌
public static void test() {} // ❌
private void test() {} // ❌

这些方法是不能被重写 / 拦截的，Proxy 无能为力。

✅ 解决：改为 public 非 final 方法

五、Object 方法不会走代理

这些方法 不会经过 InvocationHandler：

• getClass()
• hashCode()（部分）
• equals()（部分）
• toString()（部分）

六、代理对象没被使用（最容易被忽略）

❌ 错误：

ServiceImpl service = new ServiceImpl();
service.hello(); // 根本没用代理

✅ 正确：

Service proxy = createProxy();
proxy.hello();

七、Spring 中 Proxy 失效的常见场景

1️⃣ 同类方法调用（AOP 失效）

@Service
public class UserService {
    @Transactional
    public void a() {
        b();
    }

    @Transactional
    public void b() {}
}

→ b() 的事务不生效

2️⃣ 私有方法加注解

@Async
private void task() {} // ❌

3️⃣ 忘记开启代理

• 没加 @EnableAspectJAutoProxy
• 方法是 final

八、如何判断 Proxy 是否生效？

System.out.println(proxy instanceof Proxy); // true

或打印：

proxy.getClass().getName();
// com.sun.proxy.$Proxy12

九、什么时候该用 CGLIB？

✅ 以下情况：

• 没有接口
• 想代理类
• Spring 中类代理（proxyTargetClass=true）

@EnableAspectJAutoProxy(proxyTargetClass = true)

十、一句话总结

Java Proxy 失效，90% 是因为：

1. 代理了类而不是接口
2. 用了 this 调用
3. 方法是 final / private / static

如果你愿意，可以把**具体代码或框架（Spring / MyBatis / 自定义 Proxy）**贴出来，我可以直接帮你定位是哪一条原因。