java反射检查注解需满足@retention(runtime)前提，用getannotation()或isannotationpresent()判断存在性，重复注解需用getannotationsbytype()获取全部实例。

Java 反射可以通过 getAnnotation(Class<a>)</a> 方法直接检查类、方法、字段等元素上是否存在某个特定注解，前提是该注解的 @Retention 级别为 RUNTIME（只有运行时保留的注解才能通过反射获取）。

确认注解具有 RUNTIME 保留策略

这是前提条件。若注解定义中未声明 @Retention(RetentionPolicy.RUNTIME)，反射将无法读取它：

• 正确示例：

  @Target({ElementType.TYPE, ElementType.METHOD})
  @Retention(RetentionPolicy.RUNTIME)
  public @interface MyAnnotation { }

• 错误示例（反射拿不到）：

  @Retention(RetentionPolicy.CLASS) // 编译后即丢弃，反射不可见

检查类上是否存在指定注解

使用 Class.getAnnotation(Class)：

Alibabacloud Sdk Client Initialization For Java

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

下载

• 返回非 null 表示存在该注解
• 返回 null 表示不存在（或注解未在该位置声明，或保留策略不满足）

  Class> clazz = MyService.class;
  MyAnnotation anno = clazz.getAnnotation(MyAnnotation.class);
  if (anno != null) {
    // 类上有 @MyAnnotation
  }

检查方法上是否存在指定注解

先通过反射获取 Method 对象，再调用 getAnnotation：

• 注意：需确保方法名、参数类型完全匹配（可用 getDeclaredMethod 或 getMethod）
• 若方法被重载，必须传入正确的参数类型数组

  try {
    Method m = clazz.getDeclaredMethod("doSomething", String.class);
    MyAnnotation anno = m.getAnnotation(MyAnnotation.class);
    if (anno != null) {
      // 方法上有 @MyAnnotation
    }
  } catch (NoSuchMethodException e) {
    // 方法不存在
  }

批量检查多个元素或支持重复注解

若注解标注了 @Repeatable，则需用 getAnnotationsByType 获取所有实例（而不仅是第一个）：

• getAnnotation()：最多返回一个（即使重复也只取首个）
• getAnnotationsByType()：返回所有匹配的注解实例（包括容器注解隐式生成的）
• 对普通非重复注解，二者行为一致；但为兼容性与未来扩展，推荐优先用 getAnnotationsByType

  // 更通用的写法（推荐）
  MyAnnotation anno = clazz.getAnnotationsByType(MyAnnotation.class)[0]; // 至少一个才取
  // 或判断是否存在：
  if (clazz.isAnnotationPresent(MyAnnotation.class)) { ... } // 语义更清晰

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