关键在于方法返回类型（尤其是泛型）是否声明自定义注解，以及是否需在运行时基于注解对返回对象做包装处理，如自动关联查询、脱敏、权限过滤或字段映射。
反射提取方法返回值的注解，关键不在“返回值本身有没有注解”，而在于：方法的返回类型（尤其是泛型类型）上是否声明了自定义注解，以及你是否需要在运行时对返回对象做基于注解的包装处理——比如自动关联查询、脱敏、权限过滤或字段映射。java 的方法返回值本身不能直接加注解，但你可以把注解加在方法上，再约定该注解用于指导如何处理其返回值；或者把注解加在返回类型的类/字段上，通过反射递归解析。
方法级注解驱动返回值处理
这是最常用也最可控的方式：用一个运行时注解标记方法，声明它返回的对象需被特定逻辑包装。
- 定义注解，如 @AutoFetch，标注在方法上，表示需自动加载关联数据
- 在切面或拦截器中，通过反射获取该方法的
@AutoFetch实例，并检查其属性（如fetchFields = {"userProfile", "roles"}） - 拿到方法实际返回值（例如
UserDTO对象）后，根据注解配置，调用对应 service 补充字段 - 注意：必须确保方法执行完毕、返回值非 null 后再处理，避免空指针或重复代理
返回类型类/字段上的注解解析
若返回的是 POJO 或 DTO，且其内部字段已用自定义注解（如 @Sensitive、@Translate）标记，则可在包装阶段递归扫描。
- 获取返回值的 Class 对象：
result.getClass() - 遍历所有 declaredFields，对每个字段调用
field.getAnnotation(Sensitive.class) - 若存在，按规则处理字段值（如 AES 加密、替换成 * 号）
- 对字段类型是其他 Bean 的情况，递归进入其 class 继续扫描（需设深度限制，防栈溢出）
泛型返回值中的类型参数与注解联动
当方法返回 List 或 Response 时，单纯用 method.getReturnType() 只能得到 List.class 或 Response.class，真正要处理的是泛型实参 Order 或 Product。
- 调用
method.getGenericReturnType()获取ParameterizedType - 从中提取实际类型参数，例如
((Class) typeArgs[0]).getAnnotation(ApiModel.class) - 若该类型上有 @ApiModel(needWrap = true)，就对每个集合元素执行包装逻辑
- 特别注意桥接方法（bridge method）场景，需用
MethodUtils.getBridgeMethod()或手动判定
安全与性能提醒
这类反射+注解的包装逻辑通常出现在 AOP 切面或 Controller 增强中，务必注意：
- 缓存已解析的注解元信息（如 Method → Annotation 映射），避免每次调用都重复反射
- 对 null 返回值、基本类型返回值、原始集合（如
Object[]）做兜底判断 - 禁止在注解处理器里调用
getAnnotation()以外的反射写操作（如 setAccessible(true) 修改 private 字段），除非明确需要且已评估风险 - 嵌套过深（如返回值是 Map
>>）时建议配置最大解析深度，默认 3 层较稳妥
