Java反射操作类成员方法与字段详解

本文深入剖析了Java反射机制中操作私有方法与字段的核心要点与常见陷阱，强调setAccessible(true)是绕过访问控制的关键前提，同时揭示了类型匹配、final字段限制、模块化系统（JDK 9+）带来的InaccessibleObjectException等深层问题；通过对比getMethods()与getDeclaredMethods()、详解Method.invoke()和Field.get()/set()的正确用法，并指出性能损耗、Android兼容性及更优替代方案（如MethodHandle），最终回归设计本质——反射不是银弹，真正考验开发者的是何时该用、为何而用，而非如何强行突破权限。

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。

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

本篇关于《Java反射操作类成员方法与字段详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！