自定义RUNTIME注解及运行时解析方法

本文深入讲解了如何正确创建和使用 `@Retention(RetentionPolicy.RUNTIME)` 级别的自定义注解，并在运行时通过反射安全、高效地解析其元数据——从注解定义的必备要素（如 `@Target` 约束、常量类型参数、合法默认值），到实际解析中的关键细节（判空防护、声明类定位、继承陷阱、缓存优化），再到易被忽视的高阶坑点（接口默认方法、模块系统限制、重复注解遍历），全面覆盖开发中从“能用”到“用好”注解的完整实践路径，助你避开反射元编程中最常见也最隐蔽的失效与崩溃问题。

为什么 @Retention(RetentionPolicy.RUNTIME) 是前提

没有这个声明，注解在编译后就会被丢弃，运行时连 Class.getAnnotations() 都拿不到。JVM 默认只保留 SOURCE 和 CLASS 级注解，RUNTIME 是唯一能通过反射读取的级别。如果你写了注解但 getDeclaredAnnotations() 返回空数组，先检查这里。

必须搭配 @Target 明确作用位置，否则编译不通过。常见组合是：@Target({ElementType.METHOD, ElementType.TYPE}) —— 否则哪怕加了 RUNTIME，也不能用在类或方法上。

怎么定义一个带参数的 RUNTIME 注解

注解本质是接口，所有元素必须是常量类型（String、Class、enum、基本类型、其他注解，或它们的一维数组）。不能有方法体，不能继承，不能有 default null（null 不是合法默认值）。

示例：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface LogExecutionTime {
    String value() default "default";
    int thresholdMs() default 100;
    Class extends Throwable> ignoreException() default RuntimeException.class;
}

• value() 是惯用名，调用时可省略键名：@LogExecutionTime("slow")
• 数组类型写法是 String[] tags() default {}，不能写 default null
• Class 类型参数必须用 Class> 或具体泛型，不能用原始类型 Class

运行时怎么安全地获取并解析注解

反射读取注解本身很快，但频繁调用 getMethod().getAnnotation() 会有反射开销；更关键的是，注解属性访问可能抛 NullPointerException —— 比如你用 annotation.ignoreException()，而该注解没显式设置，又没设 default，就会崩。

推荐写法：

LogExecutionTime ann = method.getAnnotation(LogExecutionTime.class);
if (ann != null) {
    String label = ann.value(); // 安全：有 default 就不会 NPE
    int threshold = ann.thresholdMs();
    Class> ignoreType = ann.ignoreException(); // 注意：即使 default 是 RuntimeException.class，这里也绝不会为 null
}

• 永远先判空再取值，getAnnotation() 在找不到时返回 null，不是空数组
• 不要对注解对象做 toString() 或 equals() 判等，它只是代理对象，行为不可靠
• 如果需批量处理（如 AOP），建议缓存注解元数据，避免每次执行都反射

常见踩坑：注解生效但解析不到

最典型的情况是——你在子类方法上加了注解，却去父类的 Method 对象上调用 getAnnotation()。Java 反射的 getAnnotation() 不继承，必须从实际声明该注解的类中获取。

例如：

class Parent { void doWork() {} }
class Child extends Parent {
    @LogExecutionTime("child")
    @Override void doWork() {} // 注解在这里
}

• 错误：Parent.class.getMethod("doWork").getAnnotation(...) → 返回 null
• 正确：Child.class.getMethod("doWork").getAnnotation(...)
• 若不确定声明位置，可用 method.getDeclaringClass() 确认
• 注意：接口默认方法上的注解，要从接口类而非实现类获取

注解解析看似简单，真正难的是边界情况——继承关系、泛型擦除后 Class 参数的类型安全、重复注解（@Repeatable）的遍历顺序、还有模块系统（Java 9+）下 Module.addOpens() 对反射的限制。这些不显式踩一次，很难意识到。

理论要掌握，实操不能落！以上关于《自定义RUNTIME注解及运行时解析方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！