java Proxy 代理常见错误有哪些

在 Java 中使用 动态代理（Proxy） 或 CGLIB / ByteBuddy 等代理方式时，开发者经常会踩到一些坑。下面按常见错误类型 + 原因 + 示例/解决方式来说明。

一、JDK 动态代理常见错误

1. 代理类必须实现接口（最常见）

错误表现：

new ProxyInstance(...) 时报 ClassCastException

原因：
JDK 动态代理 只能代理接口，不能代理普通类。

class UserService { } // ❌ 非接口

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

✅ 正确方式：

interface UserService { }

class UserServiceImpl implements UserService { }

2. 忘记强转成接口类型

错误示例：

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

❌ 代理对象 不是原类类型

✅ 应该：

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

3. InvocationHandler 中未正确处理 method.invoke

错误示例：

public Object invoke(Object proxy, Method method, Object[] args) {
    return null; // ❌ 所有方法都返回 null
}

后果：

• 调用方法得到 null
• 基本类型方法会抛 NullPointerException

✅ 正确：

return method.invoke(target, args);

4. 在 InvocationHandler 中调用 proxy 自身方法（死循环）

错误示例：

public Object invoke(Object proxy, Method method, Object[] args) {
    proxy.toString(); // ❌ 无限递归
}

✅ 使用 target 对象：

target.toString();

5. equals / hashCode / toString 被代理影响

问题： 这些方法也会被代理拦截，可能导致：

• 日志无限循环
• 集合判断异常

✅ 建议特殊处理：

if (method.getName().equals("toString")) {
    return target.toString();
}

二、CGLIB 代理常见错误

6. 代理类不能是 final

final class UserService { } // ❌

CGLIB 通过 继承 实现代理，final 类无法代理。

✅ 去掉 final

7. final / private 方法无法被代理

public final void save() { }
private void log() { }

❌ 这些方法 不会走代理逻辑

8. 构造方法被执行两次

现象：

• 日志打印两次
• 初始化逻辑执行两次

原因： CGLIB 创建代理对象时会调用父类构造方法

✅ 避免在构造方法中做复杂逻辑

三、Spring AOP 代理相关错误

9. 同类方法内部调用不走代理（非常常见）

@Service
public class UserService {
    public void a() {
        b(); // ❌ 不走 AOP
    }

    @Transactional
    public void b() {}
}

✅ 解决方式：

• 自注入
• 拆分类
• 使用 AopContext.currentProxy()

10. 代理对象类型转换失败

UserServiceImpl impl = (UserServiceImpl) springBean;

❌ Spring 默认使用 JDK 动态代理（接口）

✅ 配置 CGLIB：

spring:
  aop:
    proxy-target-class: true

四、性能 & 设计类错误

11. 代理逻辑过重

• 日志、序列化、反射滥用
• 高频调用方法中加代理

✅ 只在必要层使用（Service / DAO）

12. 代理链过长

多个 AOP + 自定义 Proxy 嵌套，导致：

• 调试困难
• 性能下降

总结速查表

如果你是想看 Spring AOP / MyBatis / RPC 框架中的 Proxy 错误，或者想看 真实报错堆栈分析，可以告诉我具体场景。