BeanUtils.copyProperties常漏拷贝父类字段，因其仅处理当前类声明的属性，不递归扫描父类；需确保父类有无参构造、public getter/setter，且避免final字段。
BeanUtils.copyProperties 为什么经常漏拷贝父类字段
因为 BeanUtils.copyProperties（来自 Spring）默认只处理当前类声明的属性，不递归扫描父类字段。即使子类继承了父类的 public 字段或 getter/setter，只要这些方法在父类中定义，Spring 就可能跳过它们——尤其当父类没被显式注册为可内省类型时。
常见错误现象：copyProperties 后父类字段全为 null 或默认值，但 debug 看源对象里明明有值；用 Lombok 的 @Data 生成 getter/setter 也无效，因为 Lombok 把方法生成在子类还是父类，取决于你加在哪儿。
- 确保父类也有无参构造函数（否则内省失败，静默跳过）
- 避免父类字段是
private且没配publicgetter/setter（copyProperties不读 private 字段） - 如果用了 Spring Boot 3+，确认你用的是
org.springframework.beans.BeanUtils，不是 Apache Commons 的同名工具——后者行为更保守，连同包继承都常失效
用反射手动拷贝时怎么安全访问父类属性
反射能绕过 copyProperties 的内省限制，但必须主动遍历整个继承链。关键不是“能不能拿到”，而是“要不要设为可访问”以及“设了之后会不会破坏封装语义”。
使用场景：需要 100% 确保父子类所有非 static、非 transient 字段都被复制，比如 DTO 转 Entity 时父类含审计字段（createdAt, updatedAt）。
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 用
Class.getSuperclass()循环向上获取所有父类，对每个类调用getDeclaredFields() - 对每个
Field调用setAccessible(true)，否则 private 字段读写会抛IllegalAccessException - 注意：JDK 12+ 对
setAccessible有限制，如果跑在严格安全管理器下（如某些容器），需加 JVM 参数--illegal-access=permit（JDK 16+ 已移除，得改用模块导出） - 别忘了跳过
static和transient字段，否则可能意外覆盖类变量或序列化状态
Field[] fields = target.getClass().getDeclaredFields();
for (Field f : fields) {
f.setAccessible(true);
f.set(target, f.get(source));
}
// ❌ 错！只扫了本类。要改成 getFieldsInHierarchy(target.getClass())
性能和兼容性：BeanUtils vs 手写反射哪个更稳
BeanUtils.copyProperties 内部做了缓存（基于 PropertyDescriptor），首次调用慢，后续快；手写反射每次都要重新 getDeclaredFields()、setAccessible()，没缓存就容易成瓶颈。
但稳定性上，手写反射反而更可控：它不依赖内省机制，不看是否有 getter/setter，直接按字段名匹配，也不受 Lombok 生成策略或 IDE 自动生成代码位置的影响。
- 高频调用场景（如每秒千次 DTO 转换），建议预热
BeanUtils或改用 MapStruct 编译期生成 - 跨模块继承（父类在另一个 jar 包）、或父类用了
final字段时，BeanUtils基本失效，只能反射 - JDK 版本影响大：JDK 17 的强封装默认禁止反射访问 non-module 类，而 Spring 5.3+ 已适配，但自写反射代码若没处理模块层，运行时直接报错
最容易被忽略的坑：final 字段和不可变对象
无论用 BeanUtils 还是反射，final 字段都无法被修改——反射设值会抛 java.lang.IllegalAccessException（JDK 9+ 更严）。如果父类字段是 final，那它根本不会被拷贝，也不会报错，只是安静地维持原值。
这在用 Builder 模式构造的父类里特别隐蔽：比如父类 BaseEntity 里有 private final Long id，子类实例化后调 copyProperties，结果新对象的 id 还是 null。
- 检查父类字段是否含
final，如有，要么去掉（如果业务允许），要么在拷贝逻辑里单独处理 - 不要依赖日志或 toString() 判断拷贝是否成功，要用断言或单元测试校验具体字段值
- Lombok 的
@Value生成的类全是final字段 + 不可变构造，这种类根本不适合用任何拷贝工具，得靠构造器传参
继承链越深、修饰符越杂，拷贝逻辑就越不能靠“看起来应该行”。多一层 getSuperclass()，少一个 final，差的不是代码行数，是上线后查三天的日志。
