需递归调用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>
<ul>
<li>终止条件:当前 class 为 <code>null</code> 或是 <code>Object.class</code></li>
<li>注意:<code>getDeclaredFields()</code> 返回的是当前类“自己写的”字段,不含继承来的 public/protected 字段(那些属于父类的声明)</li>
<li>不需要过滤访问修饰符——private 字段也要包含,否则就违背了“获取所有声明字段”的初衷</li>
</ul>
<H3>通用函数实现(支持泛型与泛型擦除后的真实类型)</H3>
<p>以下是一个简洁、安全、可复用的静态工具方法:</p>
<font color="#888">
<pre><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]);
}</code></pre>
</font>
<p>说明:</p>
<ul>
<li>返回数组而非 List,保持与 JDK 原生 API(如 <code>getDeclaredFields()</code>)一致的语义</li>
<li>显式排除 <code>Object.class</code>,避免把无关的 JVM 内部字段带进来</li>
<li>字段顺序是:子类字段在前,父类字段在后(符合自底向上的遍历逻辑)</li>
<li>若需去重(极少数情况存在同名字段覆盖),可额外用 <code>LinkedHashSet</code> 按声明位置去重,但通常不建议——同名字段是合法的,应保留</li>
</ul>
<H3>使用示例与注意事项</H3>
<p>假设类结构如下:</p>
<font color="#888">
<pre><code>class A { private int a; }
class B extends A { protected String b; }
class C extends B { public double c; }</code></pre>
</font>
<p>调用 <code>getAllDeclaredFields(C.class)</code> 将返回 3 个字段:<code>c</code>(C 声明)、<code>b</code>(B 声明)、<code>a</code>(A 声明)。</p>
<ul>
<li>字段的 <code>getDeclaringClass()</code> 仍保持原始定义类,可用于区分归属</li>
<li>若需访问 private 字段,请在使用前调用 <code>field.setAccessible(true)</code></li>
<li>该方法不处理接口(<code>getInterfaces()</code>)、注解或泛型类型参数——如需完整元数据,需额外扩展</li>
</ul>
<H3>进阶:支持忽略 synthetic / bridge / enum 字段(按需)</H3>
<p>某些场景下(如序列化、DTO 映射),你可能想跳过编译器生成的字段(如枚举的 <code>$VALUES</code>、lambda 捕获字段等)。可在收集时加判断:</p>
<font color="#888">
<pre><code>if (!field.isSynthetic() && !field.isEnumConstant()) {
fields.add(field);
}</code></pre>
</font>
<p>常用过滤标识:</p>
<ul>
<li><code>field.isSynthetic()</code>:编译器生成(如外部类引用、桥接字段)</li>
<li><code>field.isEnumConstant()</code>:枚举常量字段(对应 <code>public static final</code> 枚举实例)</li>
<li><code>Modifier.isStatic(field.getModifiers())</code>:排除静态字段(如需仅实例字段)</li>
</ul>