需递归调用getdeclaredfields()并沿getsuperclass()向上遍历继承链,逐层收集各父类声明字段,排除object.class以避免jvm内部字段,最终合并为field数组。

<p>要通过反射获取一个类及其所有父类的全部声明字段(包括 private 字段),不能只调用 <code>getDeclaredFields()</code> 一次,因为该方法只返回当前类**直接声明**的字段,不包含父类字段。需要向上递归遍历继承链,逐层收集。</p> <h3>核心思路:沿 Class.getSuperclass() 向上遍历</h3> <p>Java 的类继承关系是单链结构(Object 是终点),可从目标类开始,不断调用 <code>getSuperclass()</code>,直到返回 null(即到达 Object 类之后)。每一步都调用 <code>getDeclaredFields()</code> 收集字段,并跳过 Object 类的字段(通常无实际业务意义,且其字段如 <code>shadow$_klass_</code> 等为运行时内部使用,不应暴露)。</p>
- 终止条件:当前 class 为
null或是Object.class - 注意:
getDeclaredFields()返回的是当前类“自己写的”字段,不含继承来的 public/protected 字段(那些属于父类的声明) - 不需要过滤访问修饰符——private 字段也要包含,否则就违背了“获取所有声明字段”的初衷
通用函数实现(支持泛型与泛型擦除后的真实类型)
以下是一个简洁、安全、可复用的静态工具方法:
<code>public static Field[] getAllDeclaredFields(Class> clazz) {
if (clazz == null) return new Field[0];
List<field> fields = new ArrayList();
Class> current = clazz;
while (current != null && current != Object.class) {
Collections.addAll(fields, current.getDeclaredFields());
current = current.getSuperclass();
}
return fields.toArray(new Field[0]);
}</field></code>
说明:
- 返回数组而非 List,保持与 JDK 原生 API(如
getDeclaredFields())一致的语义 - 显式排除
Object.class,避免把无关的 JVM 内部字段带进来 - 字段顺序是:子类字段在前,父类字段在后(符合自底向上的遍历逻辑)
- 若需去重(极少数情况存在同名字段覆盖),可额外用
LinkedHashSet按声明位置去重,但通常不建议——同名字段是合法的,应保留
使用示例与注意事项
假设类结构如下:
<code>class A { private int a; }
class B extends A { protected String b; }
class C extends B { public double c; }</code>
调用 getAllDeclaredFields(C.class) 将返回 3 个字段:c(C 声明)、b(B 声明)、a(A 声明)。
- 字段的
getDeclaringClass()仍保持原始定义类,可用于区分归属 - 若需访问 private 字段,请在使用前调用
field.setAccessible(true) - 该方法不处理接口(
getInterfaces())、注解或泛型类型参数——如需完整元数据,需额外扩展
进阶:支持忽略 synthetic / bridge / enum 字段(按需)
某些场景下(如序列化、DTO 映射),你可能想跳过编译器生成的字段(如枚举的 $VALUES、lambda 捕获字段等)。可在收集时加判断:
<code>if (!field.isSynthetic() && !field.isEnumConstant()) {
fields.add(field);
}</code>
常用过滤标识:
-
field.isSynthetic():编译器生成(如外部类引用、桥接字段) -
field.isEnumConstant():枚举常量字段(对应public static final枚举实例) -
Modifier.isStatic(field.getModifiers()):排除静态字段(如需仅实例字段)











