AspectJ中基于方法注解的@Pointcut与@AfterReturning未触发问题排查

你的需求完全可以实现，当前代码存在两个核心问题：切面未触发的配置/场景问题，以及即使触发也无法修改返回值的通知类型错误。

一、为什么返回值修改不生效？ #

你使用了@AfterReturning通知，该通知在方法执行完成后触发，参数中的returnValue是原返回值的副本，重新赋值returnValue = original.toLowerCase()不会改变实际返回给调用方的结果。要修改返回值，必须使用@Around通知——它能完全控制方法的执行流程，包括修改返回值。

二、为什么切面未触发？ #

切面已实例化但方法未触发，大概率是Spring AOP的代理条件未满足，排查点如下：

• 被注解的getter所在类是否被Spring管理？必须给该类添加@Component/@Service等Spring组件注解，否则Spring不会为其生成代理。
• 是否开启了AspectJ自动代理？在Spring Boot主类或配置类上添加@EnableAspectJAutoProxy注解，否则Spring不会识别并激活切面。
• 是不是同一个类内部调用？比如类里的其他方法直接调用这个getter，Spring AOP基于动态代理实现，内部调用不会经过代理，自然触发不了切面。这种情况要么改用AspectJ编译时织入，要么把调用逻辑移到其他Bean中。
• 切面类的包是否被Spring扫描到？如果切面所在包不在@ComponentScan的扫描范围内，需要调整包结构或者手动指定扫描路径。

三、修正后的切面代码 #

@Aspect
@Configuration
@EnableAspectJAutoProxy // 若主类已加此注解，此处可省略
public class AlwaysLowerAspect {
    
    private static final Logger LOG = LoggerFactory.getLogger(AlwaysLowerAspect.class);
    
    public AlwaysLowerAspect() {
        LOG.info("AlwaysLowerAspect constructed!");
    }

    @Pointcut("@annotation(com.mycompany.mypackage.AlwaysLower)")
    public void annotatedWithAlwaysLower() {}

    @Around("annotatedWithAlwaysLower()")
    public Object convertToLowercase(ProceedingJoinPoint joinPoint) throws Throwable {
        // 执行原方法获取返回值
        Object returnValue = joinPoint.proceed();
        // 仅对字符串类型做小写转换
        if (returnValue instanceof String str) {
            return str.toLowerCase();
        }
        // 非字符串类型直接返回原结果
        return returnValue;
    }
}

四、额外注意事项 #

• 若项目为纯Spring而非Spring Boot，需确保aop相关依赖已正确引入。
• 代码中使用了Java 16+的模式匹配，自动处理null值；若使用更低版本Java，可手动添加null判断。

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