getDeclaredField()这个反射方法,只负责从当前类自己声明的字段里查找——父类中定义的字段,它一概不认。即便是private字段,它也能获取到,不过想读写还需要手动调用setAccessible(true)。字段名必须严格区分大小写,不支持继承查找,一旦字段不存在,就会直接抛出NoSuchFieldException。

简而言之,getDeclaredField() 让开发者能够获取当前类自己定义的所有字段——无论访问权限是 public 还是 private,它都能暴露出来。但需要注意,它只查询本类,不会向上查找父类,也不会检查访问控制。不过默认情况下,拿到的 Field 对象仍然不能直接读写,必须配合 setAccessible(true) 才能绕过访问限制。
只获取本类声明的 private 字段(不继承)
getDeclaredField(String name) 不会向上查找父类或接口中的字段,即便父类里有一个同名的 private 字段,它也只会返回当前类中定义的那个(如果存在)。如果当前类根本没有这个字段,就会直接抛出 NoSuchFieldException。
- 子类想通过这个方法获取父类的
private字段?无法实现,即使同名也不行。 - 接口里不允许存在
private字段(Java 9+ 虽然支持private方法,但字段仍然是public static final)。 - 匿名内部类、Lambda 表达式生成的类也可以用这个方法,但字段名必须按照编译器实际生成的名称来指定,比如
val$x这种形式。
必须调用 setAccessible(true) 才能访问 private 字段
获取到 Field 对象后,它的 get() 和 set() 方法默认受 Java 访问控制限制。想要操作 private 字段,必须显式跳过检查:
Field field = clazz.getDeclaredField("secret");
field.setAccessible(true); // 必不可少的步骤
Object value = field.get(instance);
field.set(instance, newValue);
- 这一步跳过了 JVM 的访问检查,但这并不是“破坏封装”,而是反射的合法能力。
- 在启用 SecurityManager 的环境里,该方法可能被拒绝(不过现代应用几乎没人使用 SecurityManager)。
setAccessible(true)对同一个Field实例只需调用一次,后续操作无需重复。
注意字段名必须完全匹配(区分大小写)
Java 字段名严格区分大小写,而且字段名中不包含任何修饰符信息。举个例子:
- 如果类里有个
private String userName;,那么传入的字符串必须是"userName",写成"username"或"USERNAME"都不行。 - IDE 自动生成的字段(比如 Lombok 的
@Data),字段名就是代码里写的那个名称,不是 getter/setter 的名字。 - 编译器生成的合成字段(比如枚举的
$VALUES)也能通过这个方法获取,但名称需要去字节码中确认。
替代方案:getDeclaredFields() 遍历所有声明字段
如果不知道字段名,或者想批量处理本类所有 private 字段,可以使用 getDeclaredFields():
Field[] fields = clazz.getDeclaredFields();
for (Field f : fields) {
if (Modifier.isPrivate(f.getModifiers())) {
f.setAccessible(true);
// 处理 f
}
}
getDeclaredFields()返回当前类所有字段(public/protected/private/default),不包含继承来的字段。- 使用
Modifier.isPrivate(int)判断访问修饰符。 - 这个方法非常适合通用工具类(比如深拷贝、序列化框架)自动处理私有成员。
