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
相关产品推荐
相关产品推荐

