高效注解扫描需精准控制范围、延迟加载、缓存复用与生命周期匹配：优先检查isAnnotationPresent、跳过非RUNTIME注解、按需扫描限定包路径、ASM解析字节码、软引用缓存Class→Annotation映射、懒加载属性、复用Spring等框架成熟机制。
要编写高效的注解扫描与解析器，核心不在于“暴力遍历+反射调用”，而在于**精准控制扫描范围、延迟加载、缓存复用和生命周期匹配**。很多性能问题其实源于对注解保留策略（@Retention）和作用目标（@Target）理解偏差，导致做了大量无效反射操作。
明确注解的可用阶段，避免无谓反射
运行时注解只有声明为 @Retention(RetentionPolicy.RUNTIME) 才能被反射读取。如果误用 CLASS 或默认策略，method.getAnnotation(MyAnno.class) 永远返回 null，但代码仍会反复尝试——这是最隐蔽的“伪高效”。
- 先检查类/方法是否真的携带该注解：
clazz.isAnnotationPresent(MyAnno.class)比逐个获取再判空快得多 - 对非
RUNTIME注解，直接跳过反射逻辑，不进入getAnnotations()调用栈 - Spring 启动时的
ClassPathScanningCandidateComponentProvider就依赖此判断快速过滤掉不满足条件的类
按需扫描，而非全量加载
不要在应用启动时扫描整个 classpath 下所有类。应限定包路径、结合资源过滤（如只扫 com.example.service）、利用 ASM 或 Byte Buddy 直接读取字节码中的 RuntimeVisibleAnnotations 属性，绕过类加载和初始化开销。
- 使用
org.springframework.core.io.support.PathMatchingResourcePatternResolver定位.class文件，比ClassLoader.getResources()更可控 - 对每个
Resource，用ClassReader（ASM）解析AnnotationVisitor，仅提取注解名和关键属性值，不构建完整Class对象 - 跳过接口、抽象类、测试类等无关类型，用
ClassUtils.isCglibProxyClass()或字节码标志位提前排除
结果缓存与懒解析结合
注解信息本身是不可变的，同一类上的注解集合在 JVM 生命周期内不会变化。可对 Class → Map<String, Annotation> 做软引用缓存，避免重复解析；对复杂注解属性（如嵌套注解、数组），采用懒加载方式——只在真正需要某个字段时才触发 annotation.value() 反射调用。
立即学习“Java免费学习笔记（深入）”；
- 用
ConcurrentMap<Class<?>, AnnotationInfo>存储已解析结果，AnnotationInfo是轻量封装，含注解类名和原始属性 map - 避免在循环中反复调用
method.getParameterAnnotations()，应一次性提取并缓存 - Lombok 的注解处理器在编译期就完成解析和代码生成，运行时零开销——这是终极“高效”，但适用场景有限
框架集成时善用已有机制
不要从零造轮子。Spring、Micrometer、Micronaut 等主流框架都提供了成熟、经过压测的注解处理基础设施：
- Spring 的
AnnotationConfigApplicationContext内置注解驱动的 Bean 定义注册，支持@ComponentScan配置过滤器 - 使用
ReflectionUtils.doWithMethods(clazz, methodCallback, methodFilter)替代手动 for 循环，它已做 null 安全和异常屏蔽 - 对于 AOP 场景，优先用
@Aspect+@Pointcut("@annotation(com.example.MyAnno)")，由 Spring AOP 代理层统一拦截，比手写解析器更稳定且支持事务传播等上下文
