UndeclaredThrowableException 是 Java 动态代理自动包装未在接口声明的被检查异常的结果，出现原因是代理方法签名限制；应通过统一接口声明异常、转为运行时异常或内部消化来规避，必要时用 getUndeclaredThrowable() 提取原始异常。
UndeclaredThrowableException 是 Java 动态代理机制中一个特殊的运行时异常，它本身不是用来“主动捕获”未声明异常的工具，而是 Proxy 在调用目标方法时，**自动包装**那些未在接口方法签名中声明、但实际抛出的被检查异常（checked exception）的结果。你无法也不应试图“利用它来捕获”——正确做法是：理解它的出现原因，并在设计或调用层面规避或妥善处理。
为什么会出现 UndeclaredThrowableException
Java 动态代理要求：代理对象只能抛出其接口中声明的异常类型。如果目标对象的方法实际抛出了一个被检查异常（如 IOException），但该异常未在接口方法的 throws 子句中列出，JVM 代理逻辑就会将这个异常包装成 UndeclaredThrowableException 再抛出（因为代理方法签名不允许直接抛出它）。
例如：
interface Service { void doWork(); }
class RealService implements Service {
public void doWork() throws IOException { // ❌ 接口没声明 IOException
throw new IOException("disk error");
}
}
// 用 Proxy.newProxyInstance 创建代理后调用 doWork()
// → 实际抛出的是 UndeclaredThrowableException，其 cause 是 IOException
正确应对方式：从源头避免
最健壮的做法不是去 catch UndeclaredThrowableException，而是让接口契约与实现一致：
- 在接口方法中显式声明所有可能抛出的被检查异常（推荐）
- 若无法修改接口（如第三方库），可将被检查异常在实现类中转为运行时异常（如
RuntimeException或自定义 unchecked 异常）再抛出 - 使用 try-catch 在实现内部消化异常，改用返回值或状态码表达错误（适用于部分场景）
不得已时：如何安全地提取原始异常
如果必须处理已发生的 UndeclaredThrowableException（比如调试、统一错误日志、或封装 SDK），可通过其 getUndeclaredThrowable() 方法获取原始异常：
try {
proxy.doWork();
} catch (UndeclaredThrowableException e) {
Throwable cause = e.getUndeclaredThrowable();
if (cause instanceof IOException) {
// 处理 IO 问题
} else if (cause instanceof SQLException) {
// 处理数据库问题
}
}
注意：这属于补救措施，不应成为常规异常处理模式；且需确保 cause 非 null（虽然通常不为空）。
替代方案：考虑使用 CGLIB 或其他代理库
CGLIB 代理基于子类而非接口，对异常声明限制更宽松（不强制接口一致性），能直接抛出未声明的被检查异常。但需权衡：CGLIB 无法代理 final 类/方法，且引入额外依赖。仅当接口契约完全不可控且必须保留 checked exception 语义时才考虑。
