要利用反射机制在运行期动态读取类元数据并解析自定义组件注解，核心在于确保注解可被反射访问、精准获取目标元素、安全提取属性值。
确保注解声明支持运行时保留
自定义注解必须显式标注 @Retention(RetentionPolicy.RUNTIME)，否则字节码中虽存在，但 JVM 不会将其加载到运行时环境，反射调用一律返回 null 或空数组。
还需配合 @Target 指定作用位置，例如组件类常用 ElementType.TYPE，字段元数据常用 ElementType.FIELD：
-
@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME)→ 用于标记组件类（如@Service,@Controller） -
@Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME)→ 用于标注字段语义（如@ConfigValue,@Column）
准确获取 Class 对象并检查注解存在性
推荐使用 MyComponent.class 获取 Class 对象，它最稳定、不触发类初始化，也避免 Class.forName() 因静态块异常导致失败。
先用 isAnnotationPresent(YourComponent.class) 快速判断是否存在，再调用 getAnnotation(YourComponent.class) 提取实例——前者开销极小，适合条件分支；后者返回注解对象，可安全调用其方法获取配置值：
一款AI工具，主要用于使用 OpenAI Codex CLI 处理编码任务。触发词：codex、code review、fix CI、refactor code、implement feature、coding agent、gpt-5-codex。Clawdbot 可将编码工作委托给 Codex CLI 作为子代理或直接工具，适合需要提升相关任务效率的用户。
- 若注解未声明
RUNTIME，getAnnotation()总是返回null - 若类未加载或注解类不可见（如未在 classpath），可能抛
NoClassDefFoundError，建议包裹 try-catch
遍历字段/方法时需用 getDeclaredXXX() + setAccessible(true)
标准的 getFields() 或 getMethods() 只返回 public 成员，且无法访问私有字段上的注解。要完整扫描组件内部结构，必须：
- 用
getDeclaredFields()获取本类所有字段（含private、protected） - 对每个字段调用
field.getAnnotation(YourFieldAnnotation.class) - 若字段为
private，且后续需读取其值（非仅读注解），须先执行field.setAccessible(true) - 注意：
getDeclaredAnnotations()返回本类声明的所有注解（不含继承），而getAnnotations()包含父类/接口继承的注解
处理可重复注解与空值安全
若设计了 @Repeatable 注解（如多个 @Validator），不能用 getAnnotation()，必须改用 getAnnotationsByType(YourAnno.class) 才能拿到全部实例。
所有反射调用都应做空值防护：
-
clazz.getAnnotation(X.class)返回null是正常行为，不是异常 - 建议统一用
Optional.ofNullable(...).map(...).orElse(...)链式处理，避免NullPointerException - 对注解属性方法调用前，确认其有默认值或已显式赋值（无默认值的属性在使用时必须提供）
