优先用 introspector读pojo属性:它自动过滤静态/合成/桥接方法,兼容isxxx()/getxxx(),但要求类遵循javabean规范;getdeclaredfield适合绕过封装,需手动处理访问控制、继承及模块限制,且必须判空readmethod并缓存propertydescriptor。

用 Introspector 读 POJO 属性,比手写 getDeclaredField 更安全
直接说结论:对标准 JavaBean(有 getter/setter、无参构造、属性名符合规范),优先用 Introspector;它自动跳过静态字段、合成方法、桥接方法,还能处理布尔属性的 isXxx() 和 getXxx() 两种风格。手写反射容易漏掉这些细节,一上来就调 getDeclaredField("xxx"),结果遇到 private static final 或 Lombok 生成的字段就报 NoSuchFieldException。
常见错误现象:Introspector.getBeanInfo(clazz) 返回空 PropertyDescriptor,其实是因为类没遵循 JavaBean 规范——比如 getter 方法名是 get_user_id() 而不是 getUserId(),或者字段是 final 导致没有 setter。
- 确保类有 public 无参构造器(哪怕只是显式写个
public Xxx() {}) - getter/setter 必须是 public,且方法签名严格匹配:返回类型/参数类型与字段类型一致(泛型擦除后)
- 如果字段是 boolean,
Introspector会同时识别isXxx()和getXxx(),但只认其中一个——优先选isXxx(),若不存在才 fallback 到getXxx()
getDeclaredField 适合绕过封装,但必须自己处理访问控制和继承
当你需要读 private 字段、或操作没有 getter 的“伪 POJO”(比如某些 ORM 生成类、JSON 反序列化后的对象),就得用 getDeclaredField。但它不区分字段来源——父类字段、内部类字段、编译器生成的合成字段全混在一起,不加过滤就调 setAccessible(true),可能破坏安全性策略,或在 JDK 12+ 上被 SecurityManager 拦截(即使没启用也会触发检查开销)。
使用场景:单元测试中临时修改 private 状态、兼容老系统里缺少 getter 的遗留类。
立即学习“Java免费学习笔记(深入)”;
- 永远先调
field.setAccessible(true)再读写,否则IllegalAccessException - 用
clazz.getDeclaredFields()只能拿到本类声明的字段,要遍历父类得手动向上调getSuperclass() - JDK 9+ 模块系统下,如果字段所在类不在
opens或exports的包里,setAccessible(true)会静默失败(返回 false),需提前检查
PropertyDescriptor 的 readMethod 可能为空,别假设一定存在
很多人以为 Introspector 扫出来的每个 PropertyDescriptor 都有 readMethod 和 writeMethod,其实不是。比如字段只有 setter 没有 getter(如某些 builder 模式)、或 getter 是 protected(不符合 JavaBean 公共方法要求),readMethod 就是 null。直接调 pd.getReadMethod().invoke(obj) 会 NPE。
性能影响:每次调 Introspector.getBeanInfo(clazz) 都会重新扫描类结构,开销不小。生产环境必须缓存 PropertyDescriptor[],按 clazz 做 Map 缓存,别每次都重算。
- 读属性前先判空:
if (pd.getReadMethod() != null) { ... } - 缓存建议用
ConcurrentHashMap<class>, PropertyDescriptor[]></class>,避免重复扫描 - 注意:
PropertyDescriptor不支持泛型类型推导,getPropertyType()返回的是擦除后的原始类型(如List而非List<string></string>)
复杂嵌套或泛型 POJO,Introspector 够用,但得自己递归 + 类型校验
Introspector 只管单层属性,遇到 User.getAddress().getCity() 这种链式路径,它不会自动展开。你得拆成 address → city 两步,每步都查一次 PropertyDescriptor,中间任何一级为 null(比如 address == null)就得决定是抛 NullPointerException 还是返回 null。
泛型问题更隐蔽:比如字段是 Map<string order></string>,PropertyDescriptor.getPropertyType() 返回 Map.class,但 key/value 的实际类型丢了。如果后续要做 JSON 序列化或类型转换,光靠 Introspector 拿不到 Order 类型信息,得配合 Field.getGenericType() 解析 ParameterizedType。
- 链式访问时,每级 getter 调用后立刻判空,别攒到最后一起 check
- 需要泛型信息时,别只依赖
PropertyDescriptor,改用Field.getGenericType()+Class#getDeclaredField()组合 - Lombok 的
@Data类通常没问题,但@Accessors(fluent = true)会禁用标准 getter,导致Introspector找不到属性










