为何AspectJ中@annotation表达式大小写不同仍能匹配@Auditable注解？

• 核心本质：表达式里的auditable是参数变量名，不是注解类名
  Spring AOP的@Before("@annotation(auditable)")表达式中，括号里的auditable只是绑定切面方法参数的变量标识，和注解类的名称大小写没有关系。真正决定匹配逻辑的是切面方法参数的类型——也就是Auditable注解类，Spring会基于这个类型去扫描所有标注了该注解的方法。

• 匹配的实际逻辑
  当使用@annotation(变量名)这种表达式时，Spring会完成两个动作：

  1. 遍历所有方法，筛选出标注了Auditable类型注解的方法（这里匹配的是注解的实际类类型，和类名大小写严格对应，但这是Java类本身的特性，和表达式里的变量名无关）；
  2. 将找到的Auditable注解实例，赋值给切面方法中名为auditable的参数。不管这个变量名是小写auditable还是大写Auditable，只要参数类型是Auditable，就能完成绑定。

• 你代码里的错误点
  注意你的切面方法参数写的是Integer auditable，这是逻辑错误：@Auditable是一个注解实例，不是Integer类型。正确写法应该是：

  @Before("@annotation(auditable)")
  public void audit(Auditable auditable) {
    Integer code = auditable.value();
    // ...
  }
  

  原来的代码能编译可能是巧合，但根本无法正确获取注解里的value值。

• 匹配失效的常见场景
  以下情况会导致注解匹配失败：

  • 表达式直接指定注解全限定名时大小写错误：比如写成@annotation(com.example.auditable)，而实际注解类是com.example.Auditable，这里类名大小写敏感；
  • 切面方法参数类型与注解类型不匹配：比如参数写成String而非Auditable，Spring无法把注解实例注入到参数中；
  • 注解的@Retention不是RUNTIME：如果注解只保留到编译期，Spring AOP运行时扫描不到，自然无法匹配。

内容的提问来源于stack exchange，提问作者Namami Shanker