Gradle中AspectJ切面无法生效问题求助（IntelliJ IDEA环境）

在IntelliJ IDEA中使用Gradle整合AspectJ，期望通过GreetingAspect.aj的切点拦截Main类的printName静态方法，在方法执行前打印"Hello "，但始终没有预期输出。已尝试多种方法仍未解决：

已尝试的操作 #

• 安装IDEA市场的AspectJ插件（仅支持.aj文件，无效）
• 引入Gradle的AspectJ插件（io.freefair.aspectj）
• 手动导入AspectJ的jar包到lib目录
• 切换AspectJ版本（从1.9.10到1.9.7）
• 改用带@Aspect注解的Java类替代.aj文件

相关代码 #

1. GreetingAspect.aj #

package org.example;

public aspect GreetingAspect {

    pointcut greeting() : execution(* Main.printName(..));

    before() : greeting() {
        System.out.print("Hello ");
    }
}

2. build.gradle #

plugins {
    id 'java'
    id "io.freefair.aspectj" version "8.3"
}

group = 'org.example'
version = '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {

    testImplementation platform('org.junit:junit-bom:5.9.1')
    testImplementation 'org.junit.jupiter:junit-jupiter'

    runtimeOnly 'org.aspectj:aspectjweaver:1.9.7'
    runtimeOnly 'org.aspectj:aspectjrt:1.9.7'
    implementation 'org.aspectj:aspectjtools:1.9.7'

}

test {
    useJUnitPlatform()
}

3. Main类 #

package org.example;

public class Main {

    public static void main(String[] args) {
        printName("Max");
        printName("John");
        printName("Martin");
    }

    public static void printName(String name) {
        System.out.println(name);
    }
}

问题分析与解决方案 #

核心问题点 #

1. 切点表达式未指定全限定类名：原切点execution(* Main.printName(..))未明确类的全限定名，编译织入时可能无法正确匹配目标方法。
2. 依赖配置错误：aspectjrt需要在编译阶段可用，原配置用runtimeOnly会导致编译时无法找到相关类；aspectjtools由freefair插件自动引入，无需手动添加；编译织入场景下不需要aspectjweaver。
3. 未明确指定AspectJ版本：freefair插件需要明确绑定AspectJ版本，避免版本兼容问题。

修正后的代码 #

1. 修正GreetingAspect.aj的切点表达式

package org.example;

public aspect GreetingAspect {
    // 使用全限定类名匹配目标方法
    pointcut greeting() : execution(* org.example.Main.printName(..));

    before() : greeting() {
        System.out.print("Hello ");
    }
}

2. 修正build.gradle配置

plugins {
    id 'java'
    id "io.freefair.aspectj" version "8.3"
}

group = 'org.example'
version = '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

// 明确指定AspectJ版本，与插件兼容
aspectj {
    version = "1.9.7"
}

dependencies {
    testImplementation platform('org.junit:junit-bom:5.9.1')
    testImplementation 'org.junit.jupiter:junit-jupiter'

    // 调整aspectjrt为implementation，确保编译阶段可用
    implementation 'org.aspectj:aspectjrt:1.9.7'
}

test {
    useJUnitPlatform()
}

验证步骤 #

1. 执行gradle clean build清理并编译项目，确保无编译错误。
2. 运行Main类，预期输出：

Hello Max
Hello John
Hello Martin

若使用@Aspect注解的Java类替代.aj文件 #

可使用以下代码，build.gradle配置同上即可：

package org.example;

import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;

@Aspect
public class GreetingAspect {
    @Pointcut("execution(* org.example.Main.printName(..))")
    public void greeting() {}

    @Before("greeting()")
    public void beforeGreeting() {
        System.out.print("Hello ");
    }
}

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