零配置启动下自定义注解扫描需通过反射+类路径扫描实现，注解必须声明@Retention(RUNTIME)和精确@Target，使用上下文类加载器解析file/jar资源，Class.forName(..., false, cl)加载类并setAccessible(true)调用私有方法，扫描逻辑置于main或static块中。
要实现零配置启动下的自定义注解扫描，核心是绕过 Spring 的显式配置（如 @ComponentScan 或 @Import），改用纯反射 + 类路径扫描机制，在应用启动早期自动发现并处理标注了自定义注解的类或方法。这种方式轻量、可控、不依赖容器启动流程，适合嵌入式模块、脚手架工具或非 Spring 环境。
注解定义必须带 RUNTIME 保留策略
反射读取注解的前提是注解在运行期存在。若漏掉 @Retention(RetentionPolicy.RUNTIME)，getAnnotation() 或 getAnnotations() 总是返回 null 或空数组——这不是 bug，而是 JVM 规范行为。
-
@Target需精确匹配使用位置：比如注解要标在方法上，@Target(ElementType.METHOD)就不能省；若同时支持类和方法，应写成@Target({ElementType.TYPE, ElementType.METHOD}) - 避免在注解中声明
Class>类型属性：因类加载器隔离或泛型擦除，运行时可能无法正确比较或实例化 - 约定使用
value()作为默认属性，调用时可简写为@MyAnno("/api")，提升可读性
扫描类路径：兼容开发与生产环境
编译后 class 文件位置不同：IDE 下在 target/classes，打包后在 jar 的 zip 内部。需统一用 ClassLoader.getResources() 获取资源 URL，并按协议区分处理：
- URL 协议为
file：转为File对象，递归遍历目录，过滤.class文件 - URL 协议为
jar：用JarURLConnection解析 jar 包，遍历 entry 名称，提取包路径匹配的 class 条目 - 推荐使用上下文类加载器（
Thread.currentThread().getContextClassLoader()）而非当前类加载器，避免跨模块类不可见问题
反射加载与安全调用
拿到 class 名称后，不能直接 Class.forName() —— 未被加载的类不会出现在 JVM 的已知类型中，反射也查不到其注解。必须主动触发加载，并处理访问控制：
- 使用
Class.forName(className, false, classLoader)加载类（false表示不初始化，避免静态块副作用） - 对目标方法调用前，务必执行
method.setAccessible(true)，否则 private/package 方法会抛IllegalAccessException - 扫描方法优先用
getDeclaredMethods()，它包含本类所有声明方法（含私有），而getMethods()只返回 public 且含继承方法，极易遗漏
启动时机：放在 static 块或 main 入口之后
零配置意味着不依赖 Spring 生命周期。常见做法是在主类的 main 方法首行或某个工具类的 static 初始化块中触发扫描逻辑：
- 扫描包名可通过系统属性（
System.getProperty("scan.package", "com.example")）或硬编码传入，无需 XML 或注解配置 - 扫描结果建议缓存
Class对象，避免重复加载；方法处理器可预构建并注册到内存路由表或权限映射容器中 - 若需写数据库或初始化外部资源，确保在主线程完成扫描后再交由异步线程处理，防止启动阻塞或并发冲突
