You need to enable JavaScript to run this app. Spring Boot过滤器中如何获取请求URI端点的自定义注解列表
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot过滤器中如何获取请求URI端点的自定义注解列表

在Spring Boot过滤器中获取当前请求端点的方法注解

核心前提说明

  • 你当前实现的原生Servlet Filter执行时机早于Spring MVC的路由解析阶段:此时Spring还未完成当前请求与对应Controller方法的绑定,无法直接从请求对象上拿到方法注解。
  • 实现核心是主动借助Spring内置的路由映射组件,手动匹配当前请求对应的Controller方法,再从方法上提取注解信息。
  • 注意Java语法限制:自定义注解无法直接implements接口,你提到的“所有自定义注解均实现myAnnotation接口”的场景,通常是指这些自定义注解上都标注了@MyAnnotation作为元注解,后续逻辑会针对这个常见场景做适配。

具体实现步骤

1. 改造Filter类,注入Spring路由组件

把Filter注册为Spring管理的Bean,注入Spring默认的请求路由映射器RequestMappingHandlerMapping,代码参考:

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.lang.annotation.Annotation;
import java.util.Arrays;
import java.util.List;
import org.springframework.stereotype.Component;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping;

@Component
public class MyFilter implements Filter {

    private final RequestMappingHandlerMapping requestMappingHandlerMapping;

    // 构造器注入路由组件
    public MyFilter(RequestMappingHandlerMapping requestMappingHandlerMapping) {
        this.requestMappingHandlerMapping = requestMappingHandlerMapping;
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        // 注解匹配逻辑会写在这里
        // ......
        // 必须调用过滤器链放行,否则请求无法到达后续控制器
        chain.doFilter(request, response);
    }
}

2. 在doFilter中匹配请求对应的HandlerMethod

在放行逻辑之前,通过路由组件拿到当前请求对应的处理器,判断是否为Controller方法类型,再提取目标注解:

// 插入到doFilter方法中,chain.doFilter()调用之前
try {
    // 匹配当前请求对应的路由处理器
    Object handler = requestMappingHandlerMapping.getHandler(httpRequest).getHandler();

    // 仅处理Controller方法对应的处理器,跳过静态资源、错误页等非控制器场景
    if (handler instanceof HandlerMethod handlerMethod) {
        // 拿到方法上的全部注解
        Annotation[] allMethodAnnotations = handlerMethod.getMethodAnnotations();

        // 按需求过滤:只保留标注了@MyAnnotation元注解的自定义注解
        List<Annotation> targetAnnotationList = Arrays.stream(allMethodAnnotations)
                .filter(annotation -> annotation.annotationType().isAnnotationPresent(MyAnnotation.class))
                .toList();

        // 这里已经拿到了当前端点上符合要求的所有注解列表,可以执行你的埋点、逻辑校验等需求
        System.out.println("当前请求URI:" + httpRequest.getRequestURI() + ",匹配的目标注解:" + targetAnnotationList);
    }
} catch (Exception e) {
    // 兼容404、无匹配路由的场景,捕获异常直接放行即可
    e.printStackTrace();
}

关键注意点

  • 你最初写的Filter实现缺少chain.doFilter(request, response)调用,会导致请求被拦截后无法到达后续控制器,必须补上这行逻辑。
  • 要做好场景兼容:静态资源请求、Spring Boot默认错误页请求、404请求对应的处理器不是HandlerMethod类型,不要强行做类型转换引发空指针异常。
  • 如果使用Spring Boot 3+版本,需要把代码中所有javax.servlet包的依赖替换为jakarta.servlet包,核心匹配逻辑完全保持一致。
  • 如果不需要强制在原生Filter中实现该逻辑,也可以使用Spring MVC提供的HandlerInterceptor完成相同需求,它的执行时机本身就已经完成了HandlerMethod的路由匹配,代码会更简洁。

内容的提问来源于stack exchange,提问作者user12396421

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 10:24:07