java Proxy代理常见错误有哪些

在 Java 中使用 Proxy（代理）（通常指 java.lang.reflect.Proxy 动态代理，也包括 CGLIB 等代理方式）时，开发者经常会遇到一些典型错误和坑。下面按常见程度和问题类型总结：

一、JDK 动态代理常见错误

1. 被代理类没有接口

错误示例：

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

原因：

• JDK 动态代理只能代理接口，不能代理普通类。

解决：

• 为类提取接口
• 或改用 CGLIB / ByteBuddy 等字节码增强方式

2. 忘记实现 InvocationHandler

Proxy.newProxyInstance(
    loader,
    interfaces,
    null // 错误
);

原因：

• 第三个参数必须是 InvocationHandler

正确示例：

Proxy.newProxyInstance(
    loader,
    new Class[]{UserService.class},
    (proxy, method, args) -> method.invoke(target, args)
);

3. 在 InvocationHandler 中调用 proxy 自身方法（栈溢出）

(proxy, method, args) -> method.invoke(proxy, args);

结果：

• 无限递归 → StackOverflowError

正确做法：

method.invoke(target, args);

4. 代理对象强转成具体实现类

UserServiceImpl proxy = (UserServiceImpl) Proxy.newProxyInstance(...);

错误原因：

• 代理对象是接口的实现，不是原类

✅ 正确：

UserService proxy = (UserService) Proxy.newProxyInstance(...);

5. 方法返回类型不匹配

(proxy, method, args) -> "hello"; // 实际方法返回 int

异常：

ClassCastException

6. 忽略异常包装

try {
    return method.invoke(target, args);
} catch (Exception e) {
    return null;
}

问题：

• 丢失原始异常信息
• Spring 中会抛出 UndeclaredThrowableException

✅ 推荐：

try {
    return method.invoke(target, args);
} catch (InvocationTargetException e) {
    throw e.getTargetException();
}

二、代理失效 / 不生效问题

7. 自调用导致代理失效（Spring 中最常见）

@Service
public class UserService {
    public void a() {
        b(); // 代理无效
    }

    @Transactional
    public void b() {}
}

原因：

• this.b() 不经过代理对象

解决：

• 注入自己
• 使用 AopContext.currentProxy()
• 拆分成不同类

8. 方法是 final / static / private

• JDK 动态代理：不支持
• CGLIB：不能代理 final / static / private

9. 代理对象被序列化错误使用

• JDK 代理对象不可安全序列化
• Spring AOP 代理对象序列化可能失败

三、性能 & 设计问题

10. 频繁创建 Proxy 对象

Proxy.newProxyInstance(...); // 每次调用都创建

问题：

• 性能差
• 类加载器压力

✅ 缓存代理对象

11. 忽略 equals / hashCode / toString

proxy.equals(target); // false

代理对象和原对象不是同一个实例

四、ClassLoader 相关问题

12. ClassLoader 不一致

Proxy.newProxyInstance(
    target.getClass().getClassLoader(),
    interfaces,
    handler
);

错误：

• 接口和 ClassLoader 不在同一个类加载器

异常：

IllegalArgumentException: interface not visible

五、Spring / 框架中的代理误区

• 注解加在接口方法上但实现类没生效
• 用了 JDK 代理却期望代理类方法
• 混用 CGLIB 和 JDK 代理
• 代理对象被当作普通 Bean 使用

总结速查表

如果你愿意，我可以：

• ✅ 给你 JDK Proxy vs CGLIB 对比
• ✅ 分析你具体报错堆栈
• ✅ 模拟 Spring AOP 代理失效场景

直接贴代码或异常即可。