Spring 中 @EnableAspectJAutoProxy 注解未生效的原因及解决方案

在使用 Spring Boot 开发时，@EnableAspectJAutoProxy 是一个常用的注解，用于启用基于 AspectJ 的 AOP 代理。然而，有时我们可能会遇到这个注解未生效的情况，本文将分析这一问题的原因及解决方案。

问题描述

在项目中使用了 @EnableAspectJAutoProxy 注解，但在启动时发现并未生效，Spring 没有注册 AnnotationAwareAspectJAutoProxyCreator，而是注册了 InfrastructureAdvisorAutoProxyCreator。这导致 AOP 代理无法正常工作。

原因分析

这一问题通常与 Spring 的自动代理创建器注册顺序有关。具体来说，当项目中存在多个与代理相关的配置时（例如 @EnableTransactionManagement），它们可能会优先注册相应的 AutoProxyCreator，从而覆盖了 @EnableAspectJAutoProxy 的配置。

具体原因

在我的项目中，问题的根源是 ShiroConfig.java 类中使用了 @EnableTransactionManagement 注解，该注解会优先注册 InfrastructureAdvisorAutoProxyCreator，导致 @EnableAspectJAutoProxy 中的 AnnotationAwareAspectJAutoProxyCreator 未被注册。

解决方案

1. 调整注解加载顺序

解决方案：将 @EnableAspectJAutoProxy 放在其他代理相关注解（如 @EnableTransactionManagement）之前，确保它优先注册。具体来说，可以调整配置类的加载顺序，或将所有相关注解放在同一个配置类中，以确保 @EnableAspectJAutoProxy 被优先处理。

2. 移除其他手动配置的 AutoProxyCreator

方案：如果你在项目中手动配置了其他 AutoProxyCreator（如 DefaultAdvisorAutoProxyCreator），可以考虑移除它，让 @EnableAspectJAutoProxy 自动注册 AnnotationAwareAspectJAutoProxyCreator。

//@Bean
//public DefaultAdvisorAutoProxyCreator advisorAutoProxyCreator() {
//    DefaultAdvisorAutoProxyCreator advisorAutoProxyCreator = new DefaultAdvisorAutoProxyCreator();
//    advisorAutoProxyCreator.setProxyTargetClass(true);
//    return advisorAutoProxyCreator;
//}

3. 手动注册 AnnotationAwareAspectJAutoProxyCreator

方案：如果调整注解顺序和移除其他配置仍然不能解决问题，可以手动注册 AnnotationAwareAspectJAutoProxyCreator，以确保其正常工作。

@Bean
public AnnotationAwareAspectJAutoProxyCreator annotationAwareAspectJAutoProxyCreator() {
    return new AnnotationAwareAspectJAutoProxyCreator();
}

4. 启用Spring调试日志

方案：如果需要进一步调试，可以启用Spring的调试日志，以查看详细的Bean注册和初始化过程，从而定位问题根源。

logging.level.org.springframework=DEBUG

总结

在使用 @EnableAspectJAutoProxy 时，如果发现其未生效，可以首先检查项目中的其他代理相关配置是否存在优先注册的问题。通过调整注解顺序、移除其他配置或手动注册所需的 AutoProxyCreator，可以确保 @EnableAspectJAutoProxy 正常工作。