自定义注解驱动深层属性映射通过@CopyField声明字段拷贝规则，结合反射实现动态、可控的深拷贝，支持嵌套路径、类型转换、循环引用防护等，适用于运行时灵活控制场景。
自定义注解驱动深层属性映射
不靠硬编码、不写重复逻辑，用注解声明“哪些字段要拷贝”“怎么拷贝”“是否跳过”，再配合反射动态执行——这是处理复杂 POJO 映射最可控的方式。核心不是堆功能，而是把规则外置、行为可配、结构清晰。
@CopyField 注解定义字段级控制策略
先定义一个轻量但语义明确的注解，用于标记源字段与目标字段的映射关系和行为：
-
value()：指定目标字段名（支持嵌套路径如
address.city） - ignore()：设为 true 则跳过该字段，不参与拷贝
- converter()：指定类型转换器类，用于处理 String → Date、Integer → BigDecimal 等非自动兼容场景
-
deep()：设为 true 表示该字段需递归深拷贝（如 List
或嵌套对象）
示例：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface CopyField {
String value() default "";
boolean ignore() default false;
Class extends Converter> converter() default Converter.class;
boolean deep() default false;
}
反射遍历 + 递归深拷贝实现逻辑
处理器核心是两层反射：一层读取源对象字段及其注解；另一层根据注解配置决定如何写入目标对象，对 deep = true 的字段触发递归处理。
- 使用
Field.get(source)获取源值，若值为 null 且目标字段不可为空，可跳过或设默认值 - 若字段标注
@CopyField(deep = true)，且值为非基本类型，则调用自身方法递归拷贝（如 List 要 new ArrayList，每个元素再走一遍映射） - 嵌套路径（如
user.profile.avatar.url）通过点号分段，逐级 getDeclaredField + setAccessible(true)，再赋值 - 遇到 converter，实例化后调用
convert(srcValue)，将结果作为最终写入值
规避常见陷阱的关键细节
反射做深层拷贝容易出错，这几个点必须显式处理：
- 循环引用：用 Map
- final 字段：即使 setAccessible(true)，JDK 12+ 默认禁止修改 final 字段；需提前判断并跳过，或改用构造器/Builder 初始化
-
泛型擦除：List
在运行时只剩 List，需在注解中额外声明 genericType = String.class才能正确创建新集合 - 时间/枚举/BigDecimal 等特殊类型：不依赖默认 toString()，统一走 converter 机制，确保格式与业务一致
与 Spring BeanUtils / MapStruct 的定位差异
这不是替代方案，而是补充手段：
- BeanUtils 适合同名同类型、扁平结构的快速拷贝，但无法控制嵌套逻辑、跳过条件或运行时动态策略
- MapStruct 在编译期生成代码，性能好，但映射关系固定，无法根据请求参数或上下文动态开关字段
- 自定义注解 + 反射 适合需要运行时灵活控制的场景：比如导出 Excel 时按角色显示不同列、API 响应按版本过滤敏感字段、审计日志记录变更前后完整对象快照
