Java Class.getDeclaredField 怎么获取类中直接声明的 private 字段

getDeclaredField() 是 Java 反射机制中的一个方法，它仅负责从当前类自身声明的字段中进行查找，不会处理父类中定义的任何字段。即使字段是 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) 可以判断字段的访问修饰符是否为 private。
• 该方法非常适合用于通用工具类（例如深拷贝、序列化框架等）中自动处理私有成员变量。