为何AspectJ切面未触发？Gradle项目配置问题排查

1. 插件应用与版本兼容性 #

• 确保build.gradle中正确应用插件，且版本与你的Gradle版本适配：

  plugins {
      id 'java'
      id 'io.freefair.aspectj' version '8.6' // 例如Gradle 8.x对应插件8.x系列，需匹配版本
  }
  

• 避免使用过旧或超前的插件版本，容易引发兼容性冲突。

2. 切面类的注解与切点正确性 #

• 确认DemoAspect类添加了@Aspect注解，且切点表达式精准匹配Main类的目标方法：

  import org.aspectj.lang.annotation.Aspect;
  import org.aspectj.lang.annotation.Before;
  
  @Aspect
  public class DemoAspect {
      // 示例：匹配Main类下所有方法，需替换为实际包路径和方法规则
      @Before("execution(* com.example.Main.*(..))")
      public void beforeAdvice() {
          System.out.println("切面逻辑执行");
      }
  }
  

• 检查切点表达式的拼写，比如包名、方法签名是否与目标类完全一致。

3. 织入配置与编译关联 #

• 显式配置AspectJ织入参数，确保编译时织入生效：

  aspectj {
      ajc {
          options {
              compilerArgs '-Xlint:warning', '-showWeaveInfo' // 开启织入信息，方便排查
          }
      }
  }
  

• 避免自定义编译配置覆盖插件默认的Java与AspectJ编译关联逻辑。

4. 运行时类路径与构建缓存 #

• 检查build/classes/aspectj/main目录下是否生成了DemoAspect.class文件，确保切面被正确编译。
• 执行./gradlew clean build清理缓存后重新构建，再尝试运行Main类；IDEA中需同步Gradle项目后再运行。

5. 目标方法访问权限 #

• 若切点指向私有方法，需确认表达式是否正确；AspectJ支持私有方法织入，但表达式错误会导致匹配失败。

内容的提问来源于stack exchange，提问作者Alexandre Marechal Ferrant