怎么在 Java 中通过反射获取类的私有成员变量

搞 Ja va 反射的时候，想动私有成员变量，最核心的那条规则其实就一句话：setAccessible(true) 不调，你连门都进不去。别觉得这是句废话，在实际开发里，不少人就栽在这第一步上。

先看一组典型场景：用 getDeclaredField() 拿到了 Field 对象，满心欢喜去调 get() 或 set()，结果控制台直接甩你一脸 IllegalAccessException。错误信息大概长这样：“Class xxx can not access a member of class yyy with modifiers 'private'”。原因不复杂——JVM 默认的访问控制机制，不会因为你是反射就给特权，除非你主动声明“我知情，我负责”。

实际落地时，有几个细节值得留意：setAccessible(true) 必须在 get() / set() 之前调用，且对同一个 Field实例只需要调用一次；它只管当前这个 Field 对象，不影响其他的反射操作，更不会改变运行时的正常访问控制。另外，JDK 9 之后引入了模块系统，--illegal-access 策略一旦设为 deny，就算调了 setAccessible(true) 也可能不好使，这时候就得靠启动参数或者模块导出才能绕过去。

选对方法：getDeclaredField() 才是正解

很多人一上来就用 getField()，但这个方法本质上只认 public 字段——包括父类继承下来的 public 字段。对于 private、protected 或者包级私有的成员，它直接无视。真正能用的，是 getDeclaredField(String name)，它只查本类里声明的字段，不管什么修饰符。

这里有个容易被忽略的坑：它不会自动往父类里找。如果目标字段在父类中而且还是 private，你得在父类的 Class 上单独调一次 getDeclaredField()。字段名的要求也严格：大小写、下划线，一个字符不能差，否则就是 NoSuchFieldException。遇到子类重声明同名字段的情况，getDeclaredField() 只会返回当前这个类里定义的那个。

get() 传参的正确姿势

Field.get(Object obj) 的传参逻辑很简单：非静态字段，必须传具体的实例对象；静态字段，传 null 更符合惯例，但传个实例也能跑，只是不够优雅。举个例子，想拿某个 User 对象的 private String password：

Field pwdField = user.getClass().getDeclaredField("password");
pwdField.setAccessible(true);
String pwd = (String) pwdField.get(user); // user 实例不能少

类型转换这块要格外小心。get() 返回的是 Object，原始类型字段（比如 int）会自动装箱，但如果字段类型是 Integer 而值又是 null，直接强转成 int 就会触发空指针。还有一点容易被忽略：如果字段是 final 且已经初始化，在部分 JDK 版本下试图修改它的值可能会失败，尤其是字符串常量池或者编译期常量这种场景。另外，并发环境下通过反射修改私有字段，很容易破坏对象的封装契约，导致一些意料之外的行为。

批量处理时的异常粒度和作用域

当需要一次性获取类里所有私有字段时，getDeclaredFields() 能返回本类声明的全部字段，但它同样不会递归到父类。要拿到完整的字段列表，就得手动遍历整个类继承层次。还有一个不少人会踩的坑：每个 Field 都得单独调一次 setAccessible(true)，别想着对一个数组元素调一次就能覆盖全部，没这回事。

安全机制也得提一嘴。在启用了安全管理器的环境里（比如某些 Applet 或者容器），setAccessible(true) 可能会直接抛 SecurityException。放到 Android 平台上更复杂：ART 虚拟机对反射的限制越来越严格，高版本 targetSdk 下部分私有 API 会被屏蔽，setAccessible(true) 甚至可能静默失败，连个异常都不给你。

说到底，用反射改私有字段这件事，语法本身并不难，真正的考验在于理清“谁声明的字段”“在哪个类里”“有没有被模块或安全策略挡住”。排查问题的时候，别只盯着 IllegalAccessException，也多看看栈顶是不是 SecurityException 或者 NoSuchFieldException——方向对了，问题就解决了一半。