InvocationHandler的invoke方法不能直接调用目标方法，因代理不持目标实例且受检异常会触发UndeclaredThrowableException；需try-catch转为运行时异常，统一类加载器，显式处理Object方法，泛型返回值由调用方转型。
为什么 InvocationHandler 的 invoke 方法里不能直接调用目标方法
因为代理对象本身不持有目标实例，invoke 中的 method.invoke(target, args) 看似合理，但一旦目标方法抛出受检异常（比如 IOException），而接口声明没抛出它，就会触发 UndeclaredThrowableException —— 这是动态代理最隐蔽的崩溃点。
实操建议：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 始终用
try-catch包住method.invoke()，把受检异常转为运行时异常再抛出，或按需处理 - 别依赖
target是具体类；它只应是接口实现类，且必须通过构造传入，不能在invoke里硬编码 new - 如果目标方法返回
void，method.invoke()返回null，别误判为逻辑错误
如何让 Proxy.newProxyInstance 不因类加载器问题失败
常见错误现象：IllegalArgumentException: interface is not visible from class loader，尤其在 Web 容器或模块化环境（如 Spring Boot DevTools）中高频出现。
原因在于：接口和 InvocationHandler 实现类由不同类加载器加载，导致 JVM 认为“不是同一个类型”。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- 统一使用目标接口的类加载器：
MyInterface.class.getClassLoader()，而不是this.getClass().getClassLoader() - 避免在
InvocationHandler构造时传入来自不同模块的类实例（比如 OSGi bundle 边界） - 若用 Spring，优先走
@EnableAspectJAutoProxy(proxyTargetClass = false)，它内部已处理类加载器对齐
为什么 toString、hashCode、equals 在代理中表现异常
这些是 Object 自带方法，但代理对象默认不会转发给目标对象——除非你在 invoke 里显式判断并委托。否则你会拿到 Proxy@xxxx 这种 toString 结果，或两个相同目标对象的代理 equals 返回 false。
实操建议：
- 在
invoke开头加判断：if (method.getDeclaringClass() == Object.class) { return method.invoke(target, args); } - 注意：
method.getDeclaringClass()必须严格等于Object.class，不能用instanceof或名字匹配，否则会漏掉重载签名 - 如果目标对象自己重写了这些方法但行为依赖内部状态，确保
target非 null，否则NullPointerException会包装成UndeclaredThrowableException
代理接口方法返回 Future 或泛型类型时要注意什么
Java 动态代理擦除泛型，invoke 回调里的 method.getGenericReturnType() 虽能拿到 Type，但实际返回值仍是原始类型（如 Object）。如果你期望返回 Future<string></string> 却收到 Future，强转会失败。
实操建议：
- 不要在
invoke里做泛型强转；返回值类型由调用方负责转型，代理层只保证返回的是符合接口声明的实例 - 若需异步拦截（比如加超时），用
CompletableFuture.supplyAsync(() -> { ... }, executor)构造新Future，别试图修改原返回值的泛型语义 -
Future类型方法被代理后，isDone()、cancel()等行为仍由底层实现控制，代理无法“提前感知”完成状态
真正麻烦的是跨类加载器 + 泛型 + 受检异常三者叠加——这时候哪怕逻辑写对了，也会在运行时栽在 ClassNotFoundException 或 ClassCastException 上，得一层层查 getClass().getClassLoader() 才能定位。
