使用@AliasFor做注解别名时Spring AOP切面不触发如何解决？

问题根因 #

• 默认AspectJ的@annotation切点匹配规则仅会匹配方法上直接标注的精确注解类型，既不识别Spring的@AliasFor别名规则，也不会自动扫描元注解层级，所以标注了作为元注解的@ParentAnnotation的@ChildAnnotation不会被匹配到。
• 你当前的@AliasFor配置本身无效：父注解@ParentAnnotation未定义value属性，子注解中指向父注解value的别名配置会直接失效。
• 若@EnableAspectJAutoProxy未开启proxyTargetClass=true，当Controller没有实现接口时，JDK动态代理不会生效，也会导致切面无法触发。

解决方案 #

步骤1：修正注解定义 #

补全父注解的对应属性，保证@AliasFor配置合法：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
public @interface ParentAnnotation {
    // 补充与子注解别名对应的属性
    String value() default "";
}

如果不需要做属性别名透传，仅需要元注解能力，可以去掉子注解中无用的@AliasFor配置。

步骤2：调整切面逻辑，适配Spring注解规则 #

使用Spring自带的AnnotatedElementUtils做注解判断，该工具天然支持@AliasFor、元注解继承等Spring注解特性：

@Aspect
@Component
public class EventRecorderAspect {
    // 可根据业务范围缩小切点匹配路径，避免不必要的性能损耗
    @Around("execution(public * com.example.yourbusinesspackage..*.*(..))")
    public Object exampleMethod(ProceedingJoinPoint joinPoint) throws Throwable {
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method targetMethod = signature.getMethod();
        // 自动识别直接标注、元注解标注、别名配置的@ParentAnnotation
        if (AnnotatedElementUtils.hasAnnotation(targetMethod, ParentAnnotation.class)) {
            // 你的切面逻辑
        }
        return joinPoint.proceed();
    }
}

步骤3：修正代理配置 #

确保启动类/配置类上的@EnableAspectJAutoProxy开启CGLIB代理支持：

@EnableAspectJAutoProxy(proxyTargetClass = true)
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

可选方案：固定切点表达式（仅适用于子注解数量少的场景） #

如果子注解数量固定且较少，可以直接修改切点表达式同时匹配所有父子注解：

@Around("@annotation(com.example.ParentAnnotation) || @annotation(com.example.ChildAnnotation)")
public void exampleMethod(ProceedingJoinPoint joinPoint) throws Throwable {
    // 切面逻辑
}

内容的提问来源于stack exchange，提问作者Ariel Grabijas