Method.getExceptionTypes() 返回方法声明中 throws 修饰的检查型异常类型数组,按声明顺序排列,不包括运行时异常和错误;若无 throws 子句则返回空数组。

Java 中通过 Method.getExceptionTypes() 获取的异常列表,就是该方法声明中用 throws 修饰的**检查型异常(checked exception)类型数组**,不包括运行时异常(RuntimeException 及其子类)和错误(Error)。
getExceptionTypes 返回的是 throws 列表的原始类型
它直接对应源码中 throws 关键字后声明的异常类,按声明顺序返回 Class<? extends Throwable>[]。例如:
若方法定义为:void doSomething() throws IOException, SQLException { ... }
则 method.getExceptionTypes() 返回长度为 2 的数组,元素依次为 IOException.class 和 SQLException.class。
运行时异常和错误不会出现在结果中
getExceptionTypes() **只反映编译器强制要求处理的检查型异常**。即使方法体内抛出 NullPointerException 或 IllegalArgumentException,只要没在 throws 中显式声明,就不会出现在返回数组里。
常见误区:有人误以为它能反映方法实际可能抛出的所有异常 —— 实际上它只反映签名声明,与方法体内部逻辑无关。
立即学习“Java免费学习笔记(深入)”;
获取方式简单但需注意调用时机
必须在获取到 Method 对象后调用,且该方法对象需来自已加载的类(如通过 Class.getDeclaredMethod())。示例代码:
```java
Method m = MyClass.class.getDeclaredMethod("doSomething");
Class<? extends Throwable>[] exTypes = m.getExceptionTypes();
// exTypes 包含所有 throws 声明的检查异常类型
```
注意:
- 如果方法没有 throws 子句,返回空数组(new Class[0]),不是 null;
- 泛型异常(如 throws MyException<String>)会被擦除,返回原始类型 MyException.class;
- 私有方法、受保护方法同样适用,访问权限不影响 getExceptionTypes() 的结果。
可用于生成文档或做静态分析
这个 API 常用于框架或工具中,比如:
- 自动生成 API 文档中的“Throws”章节;
- 在 AOP 中预判目标方法可能抛出的异常类型,以便统一处理;
- 静态代码检查工具验证异常使用是否合规(如是否漏写 catch 或 throws)。
但它不能替代运行时异常检测,也不能推断未声明但实际可能发生的异常。


















