外部Jar包中的Aspect切面未执行问题求助

问题背景 #

在connector项目中编写Aspect切面并打包为Jar，通过Gradle依赖引入到另一个Spring Boot应用后，切面无法触发。相关代码如下：

Jar包代码 #

TrackExecutionTime.java

package a.b.aspect;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface TrackExecutionTime {}

ConnectorAOPConfig.java

package a.b.aspect;

@Aspect
@Component
public class ConnectorAOPConfig {

    public ConnectorAOPConfig() {
    }

    @Around("@annotation(a.b.aspect.TrackExecutionTime)")
    public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
        System.out.println("Inside Aspect");
        return joinPoint.proceed();
    }
}

主应用代码 #

AOPConfig.java

package a.c.config;

// Imports here

@Configuration
@EnableAspectJAutoProxy
@ComponentScan(basePackages = {"a.b.aspect"})
public class AOPConfig {
 @Bean
 public ConnectorAOPConfig aopHandler()
 {
        return new ConnectorAOPConfig();
 }
}

切面目标代码 #

@TrackExecutionTime
public static ApplicationDTO fetchApplicationByName(String name) {
    //code
    return application;
}

核心问题定位 #

切面不生效最关键的原因是目标方法为静态方法：Spring AOP基于动态代理机制，只能拦截Spring容器管理的Bean的非静态方法，静态方法属于类本身而非实例，无法被Spring代理。此外，主应用的AOP配置存在冗余Bean注册，可能引发冲突。

具体修复步骤 #

1. 将目标方法改为非静态并纳入Spring容器 #

修改目标方法为非静态，同时确保所在类被@Component/@Service等Spring注解标记，让Spring管理该类实例：

@Component
public class ApplicationService {
    @TrackExecutionTime
    public ApplicationDTO fetchApplicationByName(String name) {
        // code
        return application;
    }
}

2. 清理主应用AOP配置的冗余代码 #

主应用的@ComponentScan(basePackages = {"a.b.aspect"})已自动扫描并注册ConnectorAOPConfig（因其带有@Component注解），无需手动通过@Bean创建，删除重复定义：

package a.c.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.EnableAspectJAutoProxy;

@Configuration
@EnableAspectJAutoProxy
@ComponentScan(basePackages = {"a.b.aspect"})
public class AOPConfig {
    // 移除手动创建ConnectorAOPConfig的@Bean方法
}

3. 验证Jar包依赖引入正确性 #

确保Gradle依赖中正确引入connector项目：

dependencies {
    // 本地模块依赖
    implementation project(':connector')
    // 或远程仓库依赖
    // implementation 'your-group-id:connector:version'
}

4. 确认切面表达式有效性 #

当前ConnectorAOPConfig中的切面表达式@Around("@annotation(a.b.aspect.TrackExecutionTime)")路径正确，无需修改。

特殊场景处理（保留静态方法） #

若必须保留静态方法，需使用**AspectJ编译时织入（CTW）**替代Spring AOP动态代理，在编译阶段将切面逻辑直接织入目标类。这种方式配置复杂，需引入AspectJ编译器插件，非必要不推荐。

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