Spring Boot类与方法级注解切面空指针异常问题排查

这个问题其实是Spring AOP处理复合切点表达式时的常见陷阱，我来给你拆解原因和靠谱的解决方案：

首先，你遇到空指针的核心原因是：当使用@within(simpleAnnotation) || @annotation(simpleAnnotation)这种或逻辑的切点时，Spring AOP无法提前确定哪个注解会被匹配到。如果只有类上有注解，@annotation分支不生效，对应的simpleAnnotation参数就会被注入null；反过来只有方法有注解时，@within分支不生效，参数也会是null，自然就抛出空指针了。

而拆分成两个切面后双注解场景执行两次，是因为类和方法的切点都匹配成功，两个通知都会触发。

下面给你两种可靠的解决方案，推荐第一种，更简洁通用：

方案一：单个切面手动获取有效注解（方法注解优先） #

这种方式不依赖Spring的参数注入，而是手动从方法和类上获取注解，确保总能拿到有效的实例，同时遵循方法注解覆盖类注解的常规逻辑：

@Aspect
@Component
public class SimpleAspect {
    private static final Logger LOGGER = LoggerFactory.getLogger(SimpleAspect.class);

    @Around(value = "@within(com.example.SimpleAnnotation) || @annotation(com.example.SimpleAnnotation)")
    public Object simpleAnnotationAdvice(ProceedingJoinPoint proceedingJoinPoint) throws Throwable {
        // 先获取方法上的注解
        MethodSignature methodSignature = (MethodSignature) proceedingJoinPoint.getSignature();
        Method targetMethod = methodSignature.getMethod();
        SimpleAnnotation methodAnnotation = targetMethod.getAnnotation(SimpleAnnotation.class);

        // 方法没有注解的话，从类上获取
        SimpleAnnotation classAnnotation = proceedingJoinPoint.getTarget().getClass().getAnnotation(SimpleAnnotation.class);

        // 优先使用方法注解，兜底用类注解
        SimpleAnnotation effectiveAnnotation = methodAnnotation != null ? methodAnnotation : classAnnotation;

        LOGGER.info("Simple annotation value: {}, ASPECT-LOG {}", effectiveAnnotation.isAllowed(), proceedingJoinPoint.getSignature().getName());
        return proceedingJoinPoint.proceed();
    }
}

方案二：拆分切面+优先级控制+条件判断 #

如果你更倾向于把类和方法的逻辑分开处理，可以用两个切面，通过@Order控制方法级切面先执行，同时在类级切面中判断方法是否有注解，避免重复执行：

方法级切面（优先级更高） #

@Aspect
@Component
@Order(1)
public class MethodSimpleAspect {
    private static final Logger LOGGER = LoggerFactory.getLogger(MethodSimpleAspect.class);

    @Around("@annotation(simpleAnnotation)")
    public Object handleMethodAnnotation(ProceedingJoinPoint joinPoint, SimpleAnnotation simpleAnnotation) throws Throwable {
        LOGGER.info("Method annotation value: {}, ASPECT-LOG {}", simpleAnnotation.isAllowed(), joinPoint.getSignature().getName());
        return joinPoint.proceed();
    }
}

类级切面（优先级更低，且仅在方法无注解时执行） #

@Aspect
@Component
@Order(2)
public class ClassSimpleAspect {
    private static final Logger LOGGER = LoggerFactory.getLogger(ClassSimpleAspect.class);

    @Around("@within(simpleAnnotation)")
    public Object handleClassAnnotation(ProceedingJoinPoint joinPoint, SimpleAnnotation simpleAnnotation) throws Throwable {
        MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();
        // 如果方法上已经有注解，直接放行，不执行类级逻辑
        if (methodSignature.getMethod().getAnnotation(SimpleAnnotation.class) != null) {
            return joinPoint.proceed();
        }
        LOGGER.info("Class annotation value: {}, ASPECT-LOG {}", simpleAnnotation.isAllowed(), joinPoint.getSignature().getName());
        return joinPoint.proceed();
    }
}

为什么这两种方案能解决问题？ #

• 方案一通过手动获取注解，完全避开了Spring参数注入的null问题，同时明确了方法注解优先的规则，覆盖所有场景（仅类注解、仅方法注解、两者都有）。
• 方案二通过优先级让方法级切面先执行，再在类级切面中做判断，确保双注解场景下只有方法级逻辑生效，避免重复执行。

你可以根据自己的代码风格选择其中一种，两种方案都能完美解决你遇到的空指针和重复执行问题。

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