Spring AOP中@within通知未执行，为何不符合预期？

以下是几个最可能的原因及排查方向：

1. 目标对象未被Spring容器管理 #

如果你的目标类是通过new关键字手动实例化的，而非通过Spring的@Autowired、@Bean或容器扫描（如@Component）获取，Spring不会为其生成AOP代理，@within通知自然不会触发。

2. Spring AOP代理机制的限制 #

• JDK动态代理场景：若目标类实现了接口，Spring默认用JDK代理，但仅会代理接口中定义的方法。如果调用的是类内部未在接口声明的方法（比如私有方法、包访问方法），不会触发AOP通知。
• CGLIB代理场景：若目标类是final的，CGLIB无法生成子类代理，AOP直接失效；另外，同类方法内部调用（比如methodA()调用本类的methodB()）会绕过代理，即使methodB()符合@within条件，也不会触发通知。

3. 自定义注解的@Retention配置错误 #

类级别注解必须设置@Retention(RetentionPolicy.RUNTIME)，否则Spring在运行时无法识别该注解，@within的切入点匹配会失败。如果你的注解用了SOURCE或CLASS级别，直接修改为RUNTIME即可。

4. 切入点表达式错误 #

检查@within的表达式是否正确：

• 注解的全类名是否拼写错误（比如@within(com.xxx.MyAnnotation)中的包名、类名是否和实际注解一致）
• 若和execution()等表达式组合，是否存在逻辑冲突（比如用&&关联了互斥的条件）

5. 切面类未正确配置 #

• 切面类是否添加了@Aspect注解？
• 切面类是否被Spring扫描到（比如添加@Component，或在配置类中用@Bean声明）？
• 项目是否开启了AOP自动代理？比如配置类添加@EnableAspectJAutoProxy，或XML配置中添加<aop:aspectj-autoproxy/>

正确示例参考 #

自定义类级别注解：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface ClassLevelAnnotation {}

切面类：

@Aspect
@Component
public class WithinAspect {
    @Before("@within(com.example.ClassLevelAnnotation)")
    public void executeWithinAdvice() {
        System.out.println("@within通知已执行");
    }
}

目标类（必须被Spring管理）：

@ClassLevelAnnotation
@Component
public class TargetBean {
    public void businessMethod() {
        System.out.println("业务方法执行");
    }
}

调用方式（必须从容器获取对象）：

@Autowired
private TargetBean targetBean;

public void test() {
    targetBean.businessMethod(); // 会触发@within通知
}

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