Spring Boot中AOP自定义注解未切入ClassA方法问题排查

我是AOP新手，正在学习相关概念并编写一个简单的Spring Boot应用。我在Controller中定义了/dummy端点，在该端点内实例化ClassA并调用其consume方法，希望将自定义注解@custom应用在ClassA的consume方法上，但请求端点时切面并未触发。如果把注解加在Controller的dummyRequest方法上，切面就能正常生效。

相关代码如下：

Controller端点代码 #

@PostMapping("/dummy")
public ResponseEntity<String> dummyRequest() {
    ClassA obj = new ClassA();
    obj.consume();
    return ResponseEntity.status(HttpStatus.OK).build();
}

自定义注解代码 #

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface custom {}

切面代码 #

@Aspect
@Component
public class CustomAnnotationAspect {
    @Around("@annotation(custom)")
    public Object trace(ProceedingJoinPoint joinPoint) throws Throwable {
        Object res = null;
        System.out.println("-----ASPECT CALL--------");
        joinPoint.proceed();
        return null;
    }
}

ClassA代码 #

public class ClassA {
    @custom
    public void consume() {
        // actions
    } 
}

核心原因 #

Spring AOP默认只对Spring容器管理的Bean生效，你现在是用new ClassA()手动创建的对象，这个对象不在Spring的IoC容器中，Spring没法为它生成代理类，自然触发不了切面逻辑。而Controller本身是Spring管理的Bean，所以加在Controller方法上的注解能正常触发切面。

具体解决步骤 #

1. 把ClassA交给Spring管理
   在ClassA类上添加@Component注解，让Spring把它纳入IoC容器：

   @Component
   public class ClassA {
       @custom
       public void consume() {
           // actions
       } 
   }
   

2. 通过依赖注入获取ClassA实例
   别再手动new对象，在Controller里用@Autowired注入ClassA的实例：

   @RestController
   public class YourController {
       
       @Autowired
       private ClassA classA;
   
       @PostMapping("/dummy")
       public ResponseEntity<String> dummyRequest() {
           classA.consume();
           return ResponseEntity.status(HttpStatus.OK).build();
       }
   }
   

3. 检查AOP依赖（可选）
   确保项目已经引入了spring-boot-starter-aop依赖，Spring Boot会自动启用AOP支持。如果没加，按下面方式添加：

   • Maven（pom.xml）：

     <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-aop</artifactId>
     </dependency>
     

   • Gradle（build.gradle）：

     implementation 'org.springframework.boot:spring-boot-starter-aop'
     

补充说明 #

如果因为特殊原因不能把ClassA交给Spring管理，也可以考虑用AspectJ的编译时/加载时织入来实现，但这种方式配置更复杂，新手优先推荐Spring容器管理Bean的方案。

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