私有方法反射调用前必须调用setAccessible(true),否则抛IllegalAccessException;JDK9+需在module-info.java中opens包;Method.invoke参数类型严格匹配,基本类型不可隐式转换;反射调用比直接调用慢3–5倍且无法JIT内联;Android9+对系统类私有方法有运行时拦截。

私有方法反射调用前必须 setAccessible(true)
不调用 setAccessible(true) 就直接 invoke(),会抛出 IllegalAccessException —— 这是 JVM 的默认安全限制,和类加载器、模块系统无关,纯访问控制检查。
常见错误现象:本地 JDK 8 跑通,升级到 JDK 17 后突然失败,其实是模块系统叠加了更严的反射限制,但根本原因仍是没调 setAccessible(true)。
- 必须在
invoke()前调用,顺序不能反 - JDK 9+ 在模块化环境下,还需在
module-info.java中加opens package.name to java.base;(仅当目标类在模块内且被封装时) -
setAccessible(true)不是“永久解锁”,每次获取Method实例后都得重新设
Method.invoke() 的参数传递和类型匹配很严格
invoke() 第二个参数是 Object...,但实际传参时类型不匹配会导致 IllegalArgumentException,尤其容易栽在基本类型和包装类之间。
使用场景:比如想调用 private void process(int x, String s),传 invoke(obj, 42, "ok") 没问题;但若传 invoke(obj, Integer.valueOf(42), "ok"),JVM 仍能自动拆箱;可一旦传 Long.valueOf(42),就会报错——类型不兼容,不会隐式转换。
立即学习“Java免费学习笔记(深入)”;
- 基本类型参数必须传对应原始值或可安全拆箱的包装类(
Integer→intOK,Long→int不 OK) - 数组参数要小心:如果方法接收
String[],传new Object[]{"a","b"}会失败,得显式转成String[] - 空参方法别传
null,应传空数组:method.invoke(obj)或method.invoke(obj, (Object[])null)都行,但method.invoke(obj, null)会被当成单个null参数
反射调用比直接调用慢 3–5 倍,且无法被 JIT 内联
这不是“有点慢”,而是 JVM 明确放弃优化:Method.invoke() 是一个固定入口,内部做了参数复制、访问检查、异常包装等,JIT 编译器无法把它替换成目标方法的原生指令。
性能影响真实存在:在高频循环中每秒调用万次以上,可观测到明显 CPU 升高;如果是 Web 请求中偶尔调一次,基本无感。
- 缓存
Method实例能省掉getDeclaredMethod()开销,但对invoke()本身提速几乎为零 - 避免在
for循环里反复getDeclaredMethod()+setAccessible(true)+invoke() - 真要极致性能,考虑用
MethodHandle(JDK 7+),它支持更底层的调用协议,部分场景可接近直接调用速度,但写法更绕、调试更难
Android 上反射私有方法可能被运行时拦截
从 Android 9(Pie)开始,非 SDK 接口限制生效,调用某些系统类的私有方法(如 ActivityThread、ViewRootImpl 相关)即使 setAccessible(true) 成功,invoke() 仍会抛 RuntimeException,错误信息类似 java.lang.NoSuchMethodError: hidden method 或直接崩溃。
这不是 Java 反射机制的问题,而是 Android Runtime(ART)在方法查找阶段就做了黑名单拦截。
- 只影响对系统类的私有成员反射,你自己写的类不受限
- 可用
try-catch包住invoke()并 fallback 到兼容逻辑,但别指望 catchNoSuchMethodException就够——失败往往发生在 invoke 时 - Android 10+ 对黑名单持续收紧,建议查官方 Non-SDK interface restrictions 文档确认接口是否开放











