如何在Spring Boot中精准切入控制器子类方法并避免映射冲突

核心问题分析 #

你遇到的矛盾点在于：

• Spring AOP只能代理Spring容器中的Bean，未被扫描到的子类无法被切入；
• 但子类继承了带@RestController的父类，若将子类注册为Spring Bean（如加@Component），Spring会自动将子类识别为控制器，导致父类的@RequestMapping映射被重复注册，触发IllegalStateException: ambiguous mapping。

具体解决步骤 #

1. 调整子类的Bean注册方式 #

不要给子类添加@RestController/@Controller或@Component注解，而是通过手动配置类注册子类为普通Spring Bean，避免Spring将其识别为控制器：

@Configuration
public class DocumentControllerConfig {
    // 为每个文档子类手动注册Bean
    @Bean
    public InvoiceDocumentController invoiceDocumentController() {
        return new InvoiceDocumentController();
    }

    @Bean
    public ContractDocumentController contractDocumentController() {
        return new ContractDocumentController();
    }
}

这样子类会被Spring管理（能被AOP代理），但不会被当作REST控制器处理映射，避免冲突。

2. 保留自定义注解切点 #

继续使用@LoggableDuration注解标记需要监控的方法（父控制器、Reader类、子类目标方法），Aspect切点保持不变：

@Aspect
@Component
public class DurationLoggingAspect {
    @Pointcut("@annotation(com.yourpackage.annotation.LoggableDuration)")
    public void loggableDurationMethods() {}

    @Around("loggableDurationMethods()")
    public Object logMethodExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
        long startTime = System.nanoTime();
        Object result = joinPoint.proceed();
        long duration = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startTime);
        
        // 可替换为日志框架（如SLF4J）输出
        System.out.printf("方法 [%s] 执行耗时: %d ms%n", 
            joinPoint.getSignature().toShortString(), duration);
        
        return result;
    }
}

3. 验证关键点 #

• 子类无需继承父类的控制器注解：确保父类是@RestController，子类仅继承父类的业务逻辑方法，自身不标注任何控制器相关注解；
• 目标方法权限：子类中需要切入的方法必须是public（Spring AOP默认无法代理非公共方法，除非使用原生AspectJ织入）。

备选方案：原生AspectJ织入（若Spring AOP限制无法满足） #

如果必须让子类保持原有继承结构且不修改Bean注册方式，可以启用Spring Boot的原生AspectJ织入：

1. 添加AspectJ依赖：

<dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjweaver</artifactId>
</dependency>

2. 在启动类添加@EnableLoadTimeWeaving注解：

@SpringBootApplication
@EnableLoadTimeWeaving
public class DocumentProcessingApplication {
    public static void main(String[] args) {
        SpringApplication.run(DocumentProcessingApplication.class, args);
    }
}

这种方式无需子类成为Spring Bean，直接通过字节码织入实现切入，彻底避开Spring控制器映射冲突问题，但配置复杂度稍高。

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