Java中Class.getDeclaredField获取类中直接声明的私有字段的使用方法

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) 判断访问修饰符。
• 这个方法非常适合通用工具类（比如深拷贝、序列化框架）自动处理私有成员。