Java反射访问私有字段必须调用setAccessible(true),否则get()/set()抛IllegalAccessException;需用getDeclaredField()获取字段,静态字段get()传null,实例字段传对象;模块系统下可能抛InaccessibleObjectException。

Java反射访问私有字段必须调用 setAccessible(true)
Java反射默认受访问控制检查限制,即使通过 getDeclaredField() 获取到私有字段,直接调用 get() 或 set() 仍会抛出 IllegalAccessException。绕过该限制的唯一标准方式是显式调用 setAccessible(true)。
这个调用不是“建议”,而是强制步骤——它临时关闭 JVM 对该 Field 实例的访问检查,不修改类定义本身,也不影响其他反射对象。
-
setAccessible(true)必须在get()/set()前调用,顺序错误会导致异常 - 对同一字段多次调用
setAccessible(true)是安全的,无副作用 - 在安全管理器(
SecurityManager)启用时,该调用可能被拒绝(抛出SecurityException),但现代应用极少启用
获取私有字段要用 getDeclaredField(),不能用 getField()
getField() 只返回 public 字段(包括父类继承的 public 字段),完全忽略 private、protected 和 package-private 成员;而 getDeclaredField() 返回当前类声明的所有字段(含 private),但不包含父类字段。
- 若字段在父类中声明且为 private,需逐级调用
getSuperclass().getDeclaredField(...)向上查找 -
getDeclaredField()抛出NoSuchFieldException而非返回 null,务必捕获或声明异常 - 字段名拼写必须严格匹配(区分大小写),IDE 自动生成的 getter/setter 名不等于字段名
访问静态私有字段和实例私有字段写法一致,但 get() 参数不同
字段是否为 static 不影响反射获取方式,只影响 get() 和 set() 的参数:静态字段传 null,实例字段传具体对象引用。
立即学习“Java免费学习笔记(深入)”;
Field staticField = clazz.getDeclaredField("SOME_PRIVATE_STATIC");
staticField.setAccessible(true);
Object value = staticField.get(null); // 注意这里是 null
Field instanceField = clazz.getDeclaredField("privateInstanceField");
instanceField.setAccessible(true);
Object obj = new SomeClass();
value = instanceField.get(obj); // 这里必须传实例
- 对静态字段传非
null实例不会报错,但值始终来自类本身,与传入对象无关 - 对实例字段传
null会触发NullPointerException,不是IllegalAccessException - 若字段类型是基本类型(如
int),用getInt()/setInt()等专用方法更安全(避免自动装箱/拆箱异常)
模块系统(Java 9+)下可能遇到 InaccessibleObjectException
当目标类位于命名模块(如 java.base)且未开放对应包给你的模块时,即使调用 setAccessible(true),JVM 仍会拒绝访问并抛出 InaccessibleObjectException。这是模块系统的强封装机制,反射无法绕过。
- 常见于尝试反射
java.lang.String的value字段或ArrayList的elementData -
解决方法只有两个:改用公开 API(如
String.toCharArray()),或在module-info.java中添加opens指令(仅适用于你控制的模块) - JVM 启动参数
--add-opens java.base/java.lang=ALL-UNNAMED可临时放宽限制,但生产环境不推荐
InaccessibleObjectException 出现频率远高于 IllegalAccessException。









