Spring XML切面中类级@UserGroupAuthorize注解不生效问题

问题背景 #

在最新版SAP Commerce Cloud项目中，自定义权限注解@UserGroupAuthorize标注在方法上时能正常触发切面逻辑，但标注在类上时无法进入切面执行授权验证。

问题原因 #

当前配置的切点表达式@annotation(userGroupAuthorize)仅匹配方法级别的注解，不会识别类上标注的注解。要支持类级别注解，需要扩展切点表达式并调整切面逻辑。

解决方案 #

1. 修改Spring AOP切点表达式 #

更新spring.xml中的切点配置，同时匹配方法注解和类注解：

<aop:config proxy-target-class="true">
    <aop:aspect id="userGroupAuthorizeAspectId" ref="userGroupAuthorizeAspect">
        <!-- 同时匹配方法注解(@annotation)和类注解(@within) -->
        <aop:pointcut id="userGroupAuthorizeAnnotation" 
            expression="@annotation(userGroupAuthorize) || @within(userGroupAuthorize)"/>
        <aop:before pointcut-ref="userGroupAuthorizeAnnotation" method="authorize"/>
    </aop:aspect>
</aop:config>

2. 调整切面逻辑，兼容类/方法注解 #

修改切面类的authorize方法，通过JoinPoint获取目标类和方法上的注解，优先使用方法注解（方法注解优先级高于类注解）：

public class UserGroupAuthorizeAspect {

    private final UserService userService;

    public UserGroupAuthorizeAspect(UserService userService) {
        this.userService = userService;
    }

    public void authorize(JoinPoint joinPoint) {
        // 获取方法签名与方法实例
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method targetMethod = signature.getMethod();
        
        // 优先获取方法上的注解
        UserGroupAuthorize methodAnnotation = targetMethod.getAnnotation(UserGroupAuthorize.class);
        // 获取类上的注解
        UserGroupAuthorize classAnnotation = joinPoint.getTarget().getClass().getAnnotation(UserGroupAuthorize.class);
        
        // 确定最终使用的注解：方法注解优先，无则取类注解
        UserGroupAuthorize currentAnnotation = methodAnnotation != null ? methodAnnotation : classAnnotation;
        
        if (currentAnnotation != null) {
            UserGroup[] requiredGroups = currentAnnotation.groups();
            // 执行原有授权逻辑，例如验证当前用户所属组是否在requiredGroups中
            // ... 你的权限验证代码
        }
    }
}

3. 注解保持原有定义（无需修改） #

原注解已正确声明支持类和方法级别，无需调整：

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface UserGroupAuthorize {
    UserGroup[] groups() default {};
}

验证说明 #

• 类级别注解：标注在类上时，该类下所有方法都会触发切面逻辑，使用类注解配置的权限组。
• 方法级别注解：若方法单独标注注解，会覆盖类注解的配置，优先使用方法自身的权限组。

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