aspectj-maven-plugin忽略自定义.aj文件？Spring Data JPA注解继承问题

这个问题我之前做Spring Data JPA增强时也碰到过，分两部分给你梳理解决方案：

一、先搞定AspectJ Maven插件忽略.aj文件的配置问题 #

你遇到的插件忽略.aj文件，大概率是配置没正确指定AspectJ源文件路径或编译参数。给你一个经过验证的标准配置，你可以对照调整：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>aspectj-maven-plugin</artifactId>
    <version>1.14.0</version> <!-- 建议用最新稳定版，避免版本兼容问题 -->
    <dependencies>
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjtools</artifactId>
            <version>1.9.9.1</version> <!-- 必须和项目中aspectjrt的版本完全一致 -->
        </dependency>
    </dependencies>
    <executions>
        <execution>
            <goals>
                <goal>compile</goal> <!-- 编译主代码+AspectJ切面 -->
                <goal>test-compile</goal> <!-- 测试代码的切面也一起编译 -->
            </goals>
        </execution>
    </executions>
    <configuration>
        <source>17</source> <!-- 替换成你项目用的Java版本 -->
        <target>17</target>
        <complianceLevel>17</complianceLevel>
        <aspectDirectory>src/main/aspect</aspectDirectory> <!-- 指定你的.aj文件存放目录 -->
        <includes>
            <include>**/*.aj</include>
            <include>**/*.java</include>
        </includes>
        <showWeaveInfo>true</showWeaveInfo> <!-- 开启织入日志，方便排查是否命中目标类 -->
    </configuration>
</plugin>

另外要确认你的AnnotationInheritor.aj语法是正确的，比如要覆盖接口所有实现类的方法：

public aspect AnnotationInheritor {
    // 把ItemRepository接口及其所有实现类的方法，都加上@MyAnnotation注解
    declare @method: ItemRepository+.*(..) : @MyAnnotation;
}

这里的ItemRepository+是AspectJ的语法，代表接口本身和它的所有子类/实现类。

二、不用.aj文件，纯Java实现相同逻辑的方案 #

其实完全可以绕开AspectJ原生切面文件，用Spring AOP本身的能力解决，反而更简单——核心思路是直接匹配接口方法上的注解，不管实现类有没有继承。

Spring AOP的切入点表达式支持识别接口方法上的注解，哪怕实现类没继承注解，只要你在切入点里指定接口的方法签名+注解条件，就能精准匹配到动态生成的ItemRepositoryImpl的方法调用。

举个具体的切面代码例子：

@Aspect
@Component
public class MyAnnotationEnhancer {

    // 切入点：匹配ItemRepository接口及其所有实现类中，带有@MyAnnotation的方法
    @Pointcut("execution(* com.yourpackage.ItemRepository+.*(..)) && @annotation(myAnnotation)")
    public void myAnnotationMethod(MyAnnotation myAnnotation) {}

    @Around("myAnnotationMethod(myAnnotation)")
    public Object doEnhance(ProceedingJoinPoint joinPoint, MyAnnotation myAnnotation) throws Throwable {
        // 这里写你的增强逻辑，比如日志、权限校验、缓存等
        System.out.println("触发@MyAnnotation增强：" + joinPoint.getSignature().getName());
        return joinPoint.proceed();
    }
}

这种方案的优势很明显：

1. 完全用Java代码实现，不需要额外配置AspectJ编译插件，只要Spring AOP的基础配置（比如启动类加@EnableAspectJAutoProxy）就行
2. 避开了JVM注解不能继承的限制，因为Spring AOP是基于代理的，切入点直接识别接口方法上的注解，不管实现类有没有继承
3. 哪怕Spring Data JPA用CGLIB生成子类代理，ItemRepository+的语法也能覆盖所有实现类

如果你的需求是全局的（所有接口的注解都要“继承”到实现类），还可以写一个BeanPostProcessor在Bean初始化时，给实现类方法手动复制接口方法的注解，但这种方式复杂度更高，不如上面的AOP切入点方案简洁。

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