AspectJ基础实现失效求助：IntelliJ中切面未生效问题排查

1. 检查Maven配置是否完整（核心！） #

AspectJ需要依赖+编译插件双配置，缺任意一个都会导致切面无法织入：

依赖配置 #

确保pom.xml中引入AspectJ运行时依赖：

<dependencies>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjrt</artifactId>
        <version>1.9.7</version> <!-- 版本与下面的tools版本保持一致 -->
    </dependency>
</dependencies>

编译插件配置 #

必须添加AspectJ Maven插件实现编译时织入（CTW），这是切面生效的关键：

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>aspectj-maven-plugin</artifactId>
            <version>1.14.0</version>
            <configuration>
                <complianceLevel>11</complianceLevel> <!-- 匹配你的Java11版本 -->
                <source>11</source>
                <target>11</target>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>compile</goal> <!-- 编译主代码时织入切面 -->
                        <goal>test-compile</goal> <!-- 测试代码织入（可选） -->
                    </goals>
                </execution>
            </executions>
            <dependencies>
                <dependency>
                    <groupId>org.aspectj</groupId>
                    <artifactId>aspectjtools</artifactId>
                    <version>1.9.7</version> <!-- 与aspectjrt版本一致 -->
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

注意：插件版本与AspectJ工具包版本必须匹配，避免兼容性问题。

2. 检查切面类与切点表达式 #

• 切面类必须标注@Aspect注解，确保导入的是org.aspectj.lang.annotation.Aspect：

  import org.aspectj.lang.annotation.Aspect;
  import org.aspectj.lang.annotation.Before;
  
  @Aspect
  public class LoggingAspect {
      // 切点表达式必须精准匹配目标方法
      @Before("execution(* com.yourpackage.Greeter.greet(..))")
      public void logBefore() {
          System.out.println("切面执行：方法调用前打印日志");
      }
  }
  

• 切点表达式需注意：
  • 包路径、类名、方法名必须完全匹配实际代码
  • 通配符使用正确：*匹配任意返回值/类/方法，..匹配任意参数列表
  • 若目标方法是private/protected，需调整表达式（如execution(* com.yourpackage.Greeter.*(..))匹配所有方法）

3. 调整IntelliJ运行与编译设置 #

• 委托Maven处理编译/运行：打开Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner，勾选Delegate IDE build/run actions to Maven。这能确保IntelliJ使用AspectJ插件编译，而非内置javac。
• 验证JDK版本：确认Project Structure中的SDK为Java11，Maven全局配置（Settings -> Build, Execution, Deployment -> Build Tools -> Maven）的JRE也设置为11。
• 运行前先执行Maven编译：直接运行main方法前，先执行mvn clean compile，确保切面已织入字节码。

4. 排查织入方式问题 #

优先使用编译时织入（CTW）（即上面的Maven插件方案），这是最稳定的方式。若尝试加载时织入（LTW），需额外配置：

• 添加JVM启动参数：-javaagent:/path/to/aspectjweaver-1.9.7.jar
• 在src/main/resources/META-INF下创建aop.xml，指定切面类和目标类
  新手不建议用LTW，易出错。

5. 验证字节码织入结果 #

编译完成后，用javap -c com.yourpackage.Greeter命令查看字节码。若切面生效，目标方法的字节码中会包含切面类的调用逻辑；若没有，说明编译阶段未完成织入，回头检查Maven插件配置。

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