java注解本质是继承annotation的接口，由apt或反射处理，其行为取决于元注解：@target限定位置，@retention决定生命周期（source/class/runtime），仅runtime可反射获取。

Java注解不是语法糖，也不是运行时自动生效的“魔法”，它的行为完全取决于谁在什么时候处理它。核心就两点：编译期靠APT（或javac插件）解析，运行期靠反射读取；而注解本身只是个带元数据的接口，不执行任何逻辑。

注解的本质是接口，不是类

每个用 @interface 声明的注解，编译后都是一个继承自 java.lang.annotation.Annotation 的接口。反编译后能看到类似：

public interface MyAnnotation extends java.lang.annotation.Annotation { ... }

它没有实现类，JVM在运行时通过动态代理生成临时实现对象——也就是说，你拿到的注解实例，其实是JDK用Proxy动态创建的代理对象，不是你写的源码直接new出来的。

这解释了为什么不能在注解里写方法体、不能有静态字段、所有元素必须有默认值：因为它是接口，不是类。

@Target、@Retention这些元注解到底管什么

元注解是“描述注解的注解”，它们不参与业务逻辑，只告诉编译器和JVM怎么对待这个注解：

• @Target：限定能加在哪儿。比如 ElementType.METHOD 表示只能标在方法上；如果标在类上会编译报错
• @Retention：决定生命周期。取值为 SOURCE（仅源码期，如@Override）、CLASS（编译进字节码但不加载到JVM）、RUNTIME（可被反射读取）
• @Documented：影响Javadoc生成，加了它，该注解会出现在API文档里
• @Inherited：仅对类注解有效，表示子类可继承父类上的该注解（注意：方法/字段注解不继承）

面试常问：为什么 @Override 的 @Retention 是 SOURCE？ 因为它只用于编译期检查重写是否合法，运行时根本不需要，留着反而占字节码空间。

编译期处理 vs 运行期处理：性能与时机的关键分水岭

注解要不要在运行时反射读取，直接影响性能和设计选择：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 编译期处理（APT）：在 javac 编译阶段触发，通过 javax.annotation.processing.Processor 扫描并生成新代码（如ButterKnife旧版、Lombok、MapStruct）。优势是零运行时开销，缺点是无法处理泛型擦除后的类型信息
• 运行期处理（Reflection）：通过 Class.getAnnotation() 或 Method.getAnnotation() 获取。Spring的 @Autowired、JUnit的 @Test 都走这条路。但每次反射都有性能成本，尤其高频调用场景要谨慎

典型陷阱题：如果一个注解的 @Retention 是 CLASS，能否用反射获取？ 不能。只有 RUNTIME 级别才支持反射读取；CLASS 级别只保留在 .class 文件里，JVM加载类时不加载该注解。

自定义注解 + 反射解析的最小可行实践

写一个能真正起作用的注解，三步缺一不可：

• 定义注解：加上 @Retention(RetentionPolicy.RUNTIME) 和合适的 @Target
• 在目标类/方法上使用它
• 写解析逻辑：用反射获取注解，并根据其属性做实际操作（比如打印日志、修改行为、抛异常等）

例如，一个简单日志注解：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {}

解析时：

if (method.isAnnotationPresent(LogExecutionTime.class)) {
  System.out.println("Executing: " + method.getName());
}

注意：没加 RUNTIME，这段反射代码永远拿不到注解；没加 @Target(METHOD)，编译器就不允许你把它标在字段上。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南