非Spring Maven项目中AspectJ切面未触发问题求助

使用Java 8、TestNG、Maven、Selenium搭建UI自动化框架，尝试通过AspectJ实现方法前后自动切换iframe，但运行单个测试类时切面始终不触发，编译时织入（CTW）和加载时织入（LTW）均无效，项目为父子模块结构，业务代码在子模块Project B中。

1. 切面切点表达式完全错误 #

切面类中@Before和@After的切点表达式写错了，要匹配的是自定义注解@HandleFrame，但代码里写的是类NavigationBar的全限定名，导致切面根本找不到要拦截的方法。

修复代码：

@Aspect
public class FrameHandlingAspect { // 补全public修饰符，确保能被织入识别

    private static final Logger logger = LogManager.getLogger(FrameHandlingAspect.class); // 补全logger定义

    @Before("@annotation(com.stackoverflow.shop.HandleFrame)")
    public void enterFrame() {
        logger.info("Switched to IFrame");
        // 切换iframe逻辑
    }

    @After("@annotation(com.stackoverflow.shop.HandleFrame)")
    public void exitFrame() { // 方法名不能重复，修改原重复的enterFrame为exitFrame
        logger.info("exited from IFrame");
        // 退出iframe逻辑
    }
}

2. 隐性语法错误导致编译失败 #

• NavigationBar类使用@Override但未实现NavBarInterface，编译会报错，织入流程根本无法执行：

  // 修复NavigationBar类
  public class NavigationBar implements NavBarInterface { // 补全implements和public修饰符
  
      public NavigationBar() {} // 构造方法补全public修饰符
  
      @Override
      @HandleFrame
      public void navigateToHelp() {
          // 导航到帮助区逻辑
      }
  
      @Override
      @HandleFrame
      public void navigateToMenu() {
          // 导航到菜单逻辑
      }
  }
  

• 切面类中两个方法同名enterFrame，属于语法错误，必须修改其中一个方法名。

3. Maven织入插件未在子模块生效 #

父模块的aspectj-maven-plugin配置在pluginManagement中，仅为配置模板，子模块Project B需要在自身pom.xml的build/plugins中显式引用该插件，否则编译时织入不会执行。

子模块Project B的pom.xml添加插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>aspectj-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
        </plugin>
    </plugins>
</build>

4. 加载时织入（LTW）配置文件位置错误 #

aop.xml放在src/test/java/META-INF下，主代码（src/main/java中的类）加载时不会读取测试目录下的配置文件，导致LTW无法识别切面。

修复：
将aop.xml移动到src/main/resources/META-INF目录下，确保主类加载时能读取到织入配置。

5. Eclipse运行单个测试时未配置JavaAgent #

通过Eclipse直接运行TestNG测试类时，不会自动继承Maven的argLine参数，需要手动配置：

1. 打开TestNG Run Configuration
2. 切换到Arguments标签页
3. 在VM arguments中添加：

   -javaagent:/你的本地Maven仓库路径/org/aspectj/aspectjweaver/1.8.13/aspectjweaver-1.8.13.jar
   

6. 编译时织入的插件执行阶段问题 #

父模块中aspectj-maven-plugin的execution阶段设置为process-sources，阶段过早，需改为标准编译阶段：

<executions>
    <execution>
        <phase>compile</phase>
        <goals>
            <goal>compile</goal>
        </goals>
    </execution>
    <execution>
        <phase>test-compile</phase>
        <goals>
            <goal>test-compile</goal>
        </goals>
    </execution>
</executions>

1. 修复所有语法错误后，执行mvn clean compile，查看控制台是否有织入信息（配置了showWeaveInfo=true，会显示被织入的类）
2. 用Maven命令运行测试：mvn test -Dtest=NavigationTests，检查日志是否有切面的打印内容
3. 若用Eclipse运行，确保已添加JavaAgent参数后再执行测试类

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