Java动态代理只能代理接口,因Proxy底层生成实现接口的代理类(如$Proxy0),而JVM不允许多重继承,故无法代理普通类;传入非接口类型会抛IllegalArgumentException。

Java 动态代理中,实现 InvocationHandler 接口本身不能“自动”拦截方法——必须配合 Proxy.newProxyInstance() 创建代理对象,且目标类必须是接口实现类;否则会直接抛 IllegalArgumentException。
为什么只能代理接口,不能代理普通类
因为 Proxy 机制底层生成的是继承自 Proxy 类、并实现指定接口的字节码(如 $Proxy0),它无法继承非 final 的具体类(JVM 不允许多重继承)。若强行传入一个没有接口的类,Proxy.newProxyInstance() 会立即报错:java.lang.IllegalArgumentException: interface is required。
常见错误现象:
- 传入
new ArrayList()或new HashMap()这类实例,却没指定其接口(如List.class,Map.class)→ 报错 - 只传了
getClass().getClassLoader()和new Class[]{MyService.class},但MyService是 class 而非 interface → 报错
正确做法是:确保第二个参数是 Class>[],且每个元素都必须是 interface;目标对象只需提供实现逻辑,不参与代理类生成。
invoke() 方法里怎么安全调用原方法
增强逻辑写在 invoke() 中,但真正执行目标方法靠的是 method.invoke(target, args)。这里有几个关键点:
-
target必须是非 null 的真实对象实例(不是代理对象本身) -
method是从接口上反射拿到的,对target调用时需保证其确实实现了该方法,否则抛IllegalAccessException或IllegalArgumentException - 如果目标方法声明了受检异常(checked exception),
method.invoke()会包在InvocationTargetException里抛出,应在外层捕获并解包:e.getCause() - 避免在
invoke()中直接递归调用代理对象自身方法(比如把proxy当target传进去),会导致无限循环
示例片段:
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
System.out.println("before " + method.getName());
try {
Object result = method.invoke(target, args); // target 是真实实例
System.out.println("after " + method.getName());
return result;
} catch (InvocationTargetException e) {
throw e.getCause(); // 透出原始异常
}
}
和 CGLIB 代理的关键区别在哪
如果你的目标类没有接口,又想做方法拦截,InvocationHandler 就走不通,必须换方案:
-
InvocationHandler+Proxy:仅限接口,轻量,JDK 原生,无额外依赖 - CGLIB(如
Enhancer):通过子类继承实现代理,支持类代理,但要求目标类不能是final,方法也不能是final;且需要额外引入cglib-nodep或 Spring 的封装 - Spring AOP 默认优先用 JDK Proxy,只有当 bean 没有接口时才 fallback 到 CGLIB(需开启
@EnableAspectJAutoProxy(proxyTargetClass = true))
性能上,JDK Proxy 创建代理快,但每次调用多一层反射开销;CGLIB 创建慢(生成字节码),但运行时调用接近原生。
容易被忽略的线程安全性问题
InvocationHandler 实例本身通常被多个代理对象共享(比如一个 handler 处理多个 service 接口),但它的字段(如计数器、上下文缓存)如果不加同步或 ThreadLocal,会在并发调用时出现状态污染。
例如这个写法很危险:
private long callCount = 0;
public Object invoke(Object proxy, Method method, Object[] args) {
callCount++; // 多线程下 ++ 非原子!
return method.invoke(target, args);
}
更稳妥的方式是用 AtomicLong、ThreadLocal,或者干脆不维护共享状态——把上下文信息通过 args 或 method 参数推导,而不是靠 handler 字段。

















