如何解决Spring AOP无法对接口上标注的JAX-RS @Path方法生效的问题

你之前的判断方向完全正确，把几个容易混淆的规则拆清楚就明白为啥切面不生效了：

• 首先Java原生的注解传递机制本身就不支持接口注解的向下传递：类级别的注解哪怕加了@Inherited，也只会沿着类继承链传递，接口上的类注解、方法注解，都不会自动在实现类上被识别到。

注意：JDK规范明确说明，@Inherited元注解仅对类上声明的注解生效，方法、接口上的注解就算加了@Inherited，也不会沿着继承/实现链传递。你之前测的带@Inherited的自定义方法注解能生效，大概率是当时测的类继承场景（子类重写父类的方法），换成接口实现的场景，哪怕给自定义注解加了@Inherited，也传不到实现类的方法上。

• 再叠加Spring AOP的默认匹配逻辑：默认用JDK动态代理的时候，@annotation这种切点只会扫描目标类本身直接声明的注解，不会主动回溯接口上的注解定义。再加上javax.ws.rs.Path本身连@Inherited元注解都没加，自然接口上的@Path根本匹配不到。
• 为啥直接把@Path写在实现类上就能生效？因为注解直接声明在目标类的方法/类上，刚好符合Spring AOP的默认匹配规则，根本不需要回溯。

方案1：调整切面逻辑，主动回溯接口上的注解（改造成本最低） #

不用动你现有的接口定义，只要把原来纯靠@annotation匹配的切点，改成覆盖所有服务包下的方法，在切面逻辑里手动扫描接口上的@Path注解就行：

@Aspect
public class ReadOnlyUserAspect {
    // 先把切点范围圈到所有业务服务类，不管是接口实现还是独立类
    @Pointcut("execution(public * com.dnegi.service..*.*(..))")
    public void allServiceMethods() {}

    @Before("allServiceMethods()")
    public void logBefore(JoinPoint joinPoint) {
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method targetMethod = signature.getMethod();
        // 不管是方法本身带的，还是接口里定义的@Path，只要存在就触发拦截
        if (!hasPathAnnotation(targetMethod)) return;

        // 原有拦截逻辑直接复用
        System.out.println("logBefore() is running!");
        System.out.println("hijacked : " + joinPoint.getSignature().getName());
        System.out.println("******");
    }

    // 递归扫描目标方法、对应接口上的@Path注解
    private boolean hasPathAnnotation(Method method) {
        // 先查方法本身的直接注解
        if (method.isAnnotationPresent(Path.class)) {
            return true;
        }
        // 遍历方法所属类的所有实现接口，找同名同参数的方法上的@Path
        Class<?> declaringCls = method.getDeclaringClass();
        for (Class<?> iface : declaringCls.getInterfaces()) {
            try {
                Method ifaceMethod = iface.getMethod(method.getName(), method.getParameterTypes());
                if (ifaceMethod.isAnnotationPresent(Path.class)) {
                    return true;
                }
            } catch (NoSuchMethodException e) {
                // 接口没有对应方法就跳过，不影响逻辑
            }
        }
        return false;
    }
}

这个方案的兼容性最好，不管是把@Path写在实现类上、还是写在接口定义上，都能被拦截到，不会漏流量。

方案2：切CGLIB代理模式，优化切点匹配逻辑 #

如果不想写自定义的注解扫描工具，可以把Spring AOP的代理模式从默认的JDK动态代理改成CGLIB子类代理，减少代理对接口注解的识别盲区：

• 开启全局CGLIB代理配置：

  // Java配置类写法
  @EnableAspectJAutoProxy(proxyTargetClass = true)
  // 纯XML配置写法
  // <aop:aspectj-autoproxy proxy-target-class="true"/>
  

• 注意：哪怕开了CGLIB，原生的@annotation切点依然不会自动扫描接口上的注解，这种方案的匹配可靠性不如方案1，还是建议搭配自定义的注解扫描逻辑用。

方案3：直接用CXF原生拦截器，替换Spring AOP实现全量拦截 #

你本身是基于Apache CXF搭的JAX-RS服务，CXF原生提供的请求拦截器机制，天生就是用来做全流量管控的，根本不用靠Spring AOP的注解匹配：

• 自定义一个继承AbstractPhaseInterceptor的拦截器，绑定到请求处理的前置阶段，不管你是接口定义的服务、还是类定义的服务，所有请求都会经过这个拦截器，不会出现因为代理配置问题漏拦截的情况，可靠性比AOP高很多。

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