本文介绍如何通过递归反射遍历对象及其继承链上的所有非合成字段，精准提取已初始化的实例变量并构建成hashmap，避免inner class产生的this$0等干扰字段。
本文介绍如何通过递归反射遍历对象及其继承链上的所有非合成字段，精准提取已初始化的实例变量并构建成hashmap，避免inner class产生的this$0等干扰字段。
在Java中，使用getDeclaredFields()仅能获取当前类声明的字段，无法覆盖继承自父类的字段（如MyDocument中的documentClass、name等），这正是原始代码返回结果缺失关键字段的根本原因。同时，Contract和Summary作为非静态内部类（non-static inner classes），JVM会自动注入合成字段this$0用于持有所属外部类实例的引用——该字段既非业务所需，其名称（如this$0）也属于JVM实现细节，不应依赖字符串匹配（如!f.getName().contains("this$")）进行过滤。
✅ 正确方案：递归获取全部可访问字段 + 合成字段过滤
需满足三个核心要求：
- ✅ 覆盖整个继承链（
MyDocument→Contract/Summary） - ✅ 排除所有合成字段（使用
Field.isSynthetic()） - ✅ 仅保留非
null值字段（按需可扩展为支持基本类型判空）
以下是重构后的getProperties()方法：
public HashMap<String, Object> getProperties() throws IllegalAccessException {
HashMap<String, Object> result = new HashMap<>();
Class<?> clazz = this.getClass();
// 递归遍历类继承链：从当前类向上直到Object
while (clazz != null && !clazz.equals(Object.class)) {
for (Field field : clazz.getDeclaredFields()) {
// 跳过合成字段（如 inner class 的 this$0）和静态字段
if (field.isSynthetic() || java.lang.reflect.Modifier.isStatic(field.getModifiers())) {
continue;
}
// 确保字段可访问（处理private字段）
field.setAccessible(true);
Object value = field.get(this);
// 仅添加已初始化的字段（null值跳过；若需包含默认值，可移除此判断）
if (value != null ||
field.getType().isPrimitive() ||
(field.getType() == Boolean.class ||
field.getType() == Character.class ||
field.getType() == Byte.class ||
field.getType() == Short.class ||
field.getType() == Integer.class ||
field.getType() == Long.class ||
field.getType() == Float.class ||
field.getType() == Double.class)) {
// 对基本类型，即使未显式赋值也会有默认值（如int=0），此处保留逻辑一致性
// 实际业务中若仅需“显式赋值”字段，建议统一用包装类型并只保留 value != null 判断
result.put(field.getName(), value);
}
}
clazz = clazz.getSuperclass(); // 继续检查父类
}
return result;
}⚠️ 关键注意事项
-
内部类 vs 静态嵌套类：当前
Contract和Summary是MyDocument的非静态内部类，导致this$0必然存在。若业务上无需访问外部类实例，强烈建议改为static class Contract和static class Summary—— 这将彻底消除this$0，简化反射逻辑，提升性能与可维护性。 -
字段访问权限：
field.setAccessible(true)是必需的，否则private字段会抛出IllegalAccessException。 -
基本类型判空：Java基本类型（
int,long,boolean等）无法为null，其默认值（如0,false）可能被误认为“未赋值”。若业务语义要求仅导出显式设置过的字段，应统一使用包装类型（Integer,Boolean等），并在if (value != null)中严格过滤。 -
性能考量：反射操作开销较大，若高频调用，建议配合
java.lang.reflect.Field缓存（如ConcurrentHashMap<class>, List<field>></field></class>）或改用编译期生成工具（Lombok@Getter+ JacksonObjectMapper）。
✅ 最终效果验证
修改后运行原测试代码：
OpenJDK 24 Windows x64
下载
OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。
立即学习“Java免费学习笔记（深入）”；
Summary summ = new MyDocument().new Summary("SumName", "SumNotes");
Contract cont = new MyDocument().new Contract("ContName", "ContNotes", 12345, 67890);
System.out.println("### Summary:\n" + summ.getProperties());
System.out.println("### Contract:\n" + cont.getProperties());输出符合预期：
### Summary:
{documentClass=summary, name=SumName, notes=SumNotes, origin=area}
### Contract:
{documentClass=contract, name=ContName, notes=ContNotes, providerCode=null, providerName=null, activationDate=12345, expirationDate=67890, expirationNotifyUser=null, expirationNotifyUserType=null}注：
null值字段是否保留取决于业务需求。如需进一步过滤null，只需将if (value != null)条件加回即可。
此方案兼顾健壮性、可移植性与语义清晰性，是Java反射获取实例有效状态的标准实践。
