Java Proxy 代理为何失败

Java 中 Proxy（代理）失败是一个很常见的问题，通常不是“代理本身有 bug”，而是使用方式或条件不满足。下面按最常见原因 → 原理 → 解决办法来系统说明。

一、Java Proxy 的基本前提（先确认是否满足）

Java 动态代理（java.lang.reflect.Proxy）只能代理“接口”：

Proxy.newProxyInstance(
    classLoader,
    new Class[]{SomeInterface.class},
    invocationHandler
);

✅ 成功条件：

• 被代理对象是 接口的实现类
• 代理的是 接口方法

❌ 失败条件：

• 代理 普通类（非接口）
• 调用的是 类自己的方法（非接口方法）

二、最常见的 6 种失败原因

1️⃣ 代理了“类”而不是“接口”（最常见）

class UserService { }
Proxy.newProxyInstance(..., new Class[]{UserService.class}, ...); // ❌

❌ 报错：

java.lang.IllegalArgumentException: ... is not an interface

✅ 解决：

interface UserService { }
class UserServiceImpl implements UserService { }

2️⃣ 调用了“非接口方法”（代理不生效）

public class UserServiceImpl implements UserService {
    public void hello() { } // 接口没有
}

UserService proxy = ...;
proxy.hello(); // ❌ 不会走 InvocationHandler

✅ 原因：

• 动态代理只拦截 接口声明的方法

✅ 解决：

• 方法必须写在接口中

3️⃣ this 调用导致代理失效（Spring 中最常见）

public void a() {
    this.b(); // ❌
}

public void b() {}

即使 b() 被代理：

• this 是 原始对象
• 不走代理

✅ 解决：

• Spring 中用 AopContext.currentProxy()
• 或拆成两个 Bean

4️⃣ final 类 / final 方法（CGLIB 也救不了）

final class UserService { }

或：

final void save() { }

❌ 结果：

• JDK 动态代理：不支持
• CGLIB：无法继承

✅ 解决：

• 去掉 final

5️⃣ 代理对象类型转换错误

UserServiceImpl impl = (UserServiceImpl) proxy; // ❌

✅ 正确：

UserService userService = (UserService) proxy;

6️⃣ 类加载器不一致（少见但坑）

Proxy.newProxyInstance(
    OtherClassLoader,
    new Class[]{UserService.class},
    handler
);

❌ 报错：

ClassCastException

✅ 解决：

• 使用 接口所在的 ClassLoader

三、JDK Proxy vs CGLIB 区别（避免用错）

四、快速自查清单 ✅

代理失败请依次检查：

• [ ] 是否代理的是 接口
• [ ] 是否调用的是 接口方法
• [ ] 是否使用了 this
• [ ] 是否有 final
• [ ] 是否类型转换错误
• [ ] 是否类加载器不一致

五、如果你愿意

你可以直接贴：

• 报错信息
• 代理代码
• 使用场景（Spring / MyBatis / RPC）

我可以精准定位你这个代理为什么失败。