Spring Boot中如何优雅匹配请求与对应控制器方法？

你可以借助Spring自身的RequestMappingHandlerMapping和RequestMappingInfo机制实现这个需求，完全替代手动字符串匹配的方式。核心思路是提前缓存所有控制器方法的路由映射信息，然后通过映射信息直接匹配请求，无需触发方法执行。

具体实现步骤 #

1. 缓存控制器方法的映射信息
   创建一个组件，在Spring上下文初始化完成后，从RequestMappingHandlerMapping中提取所有控制器方法的RequestMappingInfo（包含URL、HTTP方法、参数等所有路由规则），并以方法签名（如FooController::getFoo）为键缓存起来：

   @Component
   public class HandlerMethodMappingCache implements ApplicationListener<ContextRefreshedEvent> {
       private final Map<String, RequestMappingInfo> methodMappingCache = new HashMap<>();
   
       @Override
       public void onApplicationEvent(ContextRefreshedEvent event) {
           RequestMappingHandlerMapping handlerMapping = event.getApplicationContext()
                   .getBean(RequestMappingHandlerMapping.class);
           Map<RequestMappingInfo, HandlerMethod> handlerMethods = handlerMapping.getHandlerMethods();
   
           for (var entry : handlerMethods.entrySet()) {
               HandlerMethod handlerMethod = entry.getValue();
               // 生成基础方法签名
               String signature = handlerMethod.getBeanType().getSimpleName() + "::" + handlerMethod.getMethod().getName();
               // 如需处理重载方法，可追加参数类型区分：
               // String signature = handlerMethod.getBeanType().getSimpleName() + "::" + 
               //     handlerMethod.getMethod().getName() + Arrays.stream(handlerMethod.getMethod().getParameterTypes())
               //         .map(Class::getSimpleName)
               //         .collect(Collectors.joining(",", "(", ")"));
               methodMappingCache.put(signature, entry.getKey());
           }
       }
   
       public RequestMappingInfo getRequestMappingInfo(String methodSignature) {
           return methodMappingCache.get(methodSignature);
       }
   }
   

2. 在Interceptor中实现匹配逻辑
   注入上述缓存组件，编写matches方法，利用RequestMappingInfo自带的匹配能力判断请求是否对应目标控制器方法：

   @Component
   public class CustomAuthInterceptor implements HandlerInterceptor {
       private final HandlerMethodMappingCache mappingCache;
   
       public CustomAuthInterceptor(HandlerMethodMappingCache mappingCache) {
           this.mappingCache = mappingCache;
       }
   
       @Override
       public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
           // 判断当前请求是否匹配FooController的getFoo方法
           boolean isFooGetMatched = matches("FooController::getFoo", request);
           if (isFooGetMatched) {
               // 执行FooController::getFoo对应的授权逻辑
           }
   
           // 判断当前请求是否匹配BarController的createBar方法
           boolean isBarPostMatched = matches("BarController::createBar", request);
           if (isBarPostMatched) {
               // 执行BarController::createBar对应的授权逻辑
           }
   
           return true;
       }
   
       private boolean matches(String methodSignature, HttpServletRequest request) {
           RequestMappingInfo mappingInfo = mappingCache.getRequestMappingInfo(methodSignature);
           if (mappingInfo == null) {
               return false;
           }
           // 复用Spring原生匹配逻辑，自动处理URL路径、HTTP方法、参数等所有规则
           return mappingInfo.matches(new ServletWebRequest(request));
       }
   }
   

关键优势 #

• 完全复用Spring的路由匹配逻辑，避免手动字符串匹配的疏漏（比如路径变量、通配符、HTTP方法匹配错误等）
• 无需硬编码URL和方法，直接通过控制器方法签名关联，代码可读性和维护性更高
• 支持所有@RequestMapping相关的匹配规则（包括@GetMapping、@PostMapping等派生注解）

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