AspectJ切面获取自定义注解值时出现“formal unbound in pointcut”错误

问题分析 #

启动报错java.lang.IllegalArgumentException: error at ::0 formal unbound in pointcut，核心原因是切面Advice方法中的注解参数未与切点表达式正确绑定，Spring无法识别方法参数对应的切点元素。

另外还有两个易忽略的细节问题：

1. 自定义注解中entitlements()返回String[]类型，但默认值设为""（String类型），属于类型不匹配，会导致后续运行异常。
2. @Around方法返回值写为void，会丢失被拦截方法的返回值，不符合AOP的规范用法。

正确解决方案 #

1. 修正自定义注解（必要） #

将注解中数组类型的默认值改为空数组：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Authorize {
    String[] entitlements() default {};
}

2. 修正切面代码 #

修改切点表达式，将注解实例与方法参数关联起来：

@Aspect
@Component
public class AspectHandler{
    // 用@annotation(authorize)绑定注解实例与方法参数
    @Around(value = "@annotation(authorize)")
    public Object authValidator(ProceedingJoinPoint point, Authorize authorize) throws Throwable {
        String[] entitlements = authorize.entitlements();
        // 在此添加你的权限校验逻辑
        // 执行原方法并返回结果
        return point.proceed();
    }
}

如果需要明确指定注解的全类名，也可以写成：

@Around(value = "@annotation(com.myorg.authorization.annotations.Authorize authorize)")

3. 规避错误写法 #

• 错误使用argNames：之前仅指定argNames = "authorize"，但方法包含两个参数，正确写法应为argNames = "point,authorize"（不过只要参数名与切点中声明的一致，通常不需要显式指定）。
• 错误使用args=authorize：args用于匹配目标方法的参数，而非注解参数，不能用来绑定注解实例。

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