Java反射调用私有方法需先调用setAccessible(true),再invoke();读写私有字段同理,且需注意类型匹配、final字段限制及模块化访问控制。

Java 反射中 Method 和 Field 是操作类成员的核心类型,但直接用它们读写私有成员、调用方法时极易抛出 IllegalAccessException 或 IllegalArgumentException —— 根本原因不是代码写错了,而是没正确处理访问权限控制。
如何获取并调用私有方法(Method.invoke())
反射调用私有方法必须显式设置可访问性,否则即使能 getDeclaredMethod() 成功,invoke() 也会失败。
-
setAccessible(true)必须在invoke()前调用,且对每个Method实例单独设置 - 若方法有参数,传入的实参类型必须与声明类型兼容(如
int不能直接传Integer,除非自动拆箱成功) - 静态方法的第一个参数传
null;实例方法第一个参数必须是目标对象引用 - 调用返回
void的方法时,invoke()返回null,不是Void
Class> clazz = MyClass.class;
Method method = clazz.getDeclaredMethod("privateMethod", String.class);
method.setAccessible(true); // 关键一步
Object result = method.invoke(new MyClass(), "hello");
如何安全读写私有字段(Field.get()/set())
Field 的读写比 Method 更容易踩坑:字段类型不匹配、未设 setAccessible(true)、对 final 字段误写都会导致异常或静默失败。
-
getDeclaredField()才能拿到私有字段;getField()只返回 public 字段 - 读取基本类型字段(如
int)请用getInt()等专用方法,避免装箱/拆箱异常 - 修改
final字段需先用modifiers字段绕过 JVM 检查(JDK 12+ 默认禁止,需启动参数--add-opens) - 字段值为
null时,对基本类型字段调用get()会抛IllegalArgumentException
Field field = clazz.getDeclaredField("privateValue");
field.setAccessible(true);
String value = (String) field.get(instance); // 注意类型强转
field.set(instance, "new value");
为什么 getMethods() 拿不到私有方法?
getMethods() 只返回当前类及所有父类中 public 的方法(含继承的),它根本不会扫描 private / protected 方法。这是设计使然,不是 bug。
立即学习“Java免费学习笔记(深入)”;
- 要获取本类所有声明的方法(含 private),必须用
getDeclaredMethods() -
getDeclaredMethods()不包含继承方法,哪怕父类是 public 方法也不会出现 - 如果需要“本类定义的所有方法 + 父类 public 方法”,得手动合并两组结果并去重
- 泛型方法的类型信息需通过
getGenericReturnType()获取,getReturnType()只返回擦除后的原始类型
性能与模块化限制(JDK 9+)
从 JDK 9 开始,模块系统默认阻止反射访问非 open 模块的内部 API,即使写了 setAccessible(true) 也会抛 InaccessibleObjectException。
- 解决办法是在运行时加 JVM 参数:
--add-opens java.base/java.lang=ALL-UNNAMED - 频繁反射调用比直接调用慢 5–50 倍,尤其涉及参数解析和访问检查时;建议缓存
Method/Field实例 -
MethodHandle是更轻量的替代方案,但无法绕过模块限制,且调试难度更高 - Android 上 ART 虚拟机对反射有额外限制,某些系统类字段可能完全不可访问
真正麻烦的从来不是“怎么写”,而是“什么时候该用”——比如序列化框架依赖反射,但业务代码里硬写 setAccessible(true) 往往意味着设计上可以暴露接口或改用策略模式。权限绕过只是手段,不是目的。










