在Java中如何使用Method与Field操作类成员_Java反射API说明

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

Java 反射中 MethodField 是操作类成员的核心类型,但直接用它们读写私有成员、调用方法时极易抛出 IllegalAccessExceptionIllegalArgumentException —— 根本原因不是代码写错了,而是没正确处理访问权限控制。

如何获取并调用私有方法(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。

  • 要获取本类所有声明的方法(含 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) 往往意味着设计上可以暴露接口或改用策略模式。权限绕过只是手段,不是目的。