优先用 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免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 永远先调
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找不到属性
