# SpringMVC中Controller的查找原理是什么 ## 引言 SpringMVC作为Java Web开发中最流行的框架之一，其核心功能是将HTTP请求映射到对应的Controller方法进行处理。理解Controller的查找机制对于深入掌握SpringMVC工作原理、排查请求映射问题以及进行框架扩展都至关重要。本文将全面剖析SpringMVC中Controller的查找原理，从请求进入容器到最终方法执行的完整流程。 ## 一、SpringMVC请求处理整体流程 ### 1.1 请求生命周期概述 ```java // 简化版请求处理流程示意 1. Http请求到达DispatcherServlet 2. 调用doDispatch()方法 3. 通过HandlerMapping获取HandlerExecutionChain 4. 通过HandlerAdapter执行Handler 5. 返回ModelAndView 6. 视图渲染 作为前端控制器，DispatcherServlet是SpringMVC的核心入口，负责协调各组件完成请求处理：
| 实现类 | 适用场景 | 特点 |
|---|---|---|
| RequestMappingHandler | 注解驱动的控制器 | 支持@RequestMapping |
| BeanNameUrlHandler | 基于Bean名称的映射 | 简单但不够灵活 |
| SimpleUrlHandler | 显式URL到Controller的映射 | 需要手动配置映射关系 |
// AbstractHandlerMapping初始化关键代码 public void initApplicationContext() { // 1. 初始化拦截器 initInterceptors(); // 2. 注册MappedInterceptor detectMappedInterceptors(); // 3. 模板方法供子类实现 initHandlerMethods(); } // RequestMappingHandlerMapping的实现 protected void initHandlerMethods() { // 扫描所有Bean的元数据 for (String beanName : getCandidateBeanNames()) { // 处理带有@Controller/@RequestMapping的Bean detectHandlerMethods(beanName); } handlerMethodsInitialized(getHandlerMethods()); } SpringMVC使用多层数据结构存储映射关系：
Map<RequestMappingInfo, HandlerMethod> MultiValueMap<String, T> urlMap Map<String, List<HandlerMethod>> nameMap URL路径匹配：
HTTP方法过滤：
// RequestMappingInfo的methods匹配逻辑 public boolean matches(MockHttpServletRequest request) { if (this.methods != null && !this.methods.isEmpty()) { return this.methods.contains(request.getMethod()); } return true; } 请求参数条件检查：
内容类型协商：
SpringMVC按照以下优先级确定最终匹配的处理器：
场景1：路径变量冲突
@GetMapping("/users/{id}") public String getUser(@PathVariable Long id) {...} @GetMapping("/users/list") public String listUsers() {...} 处理流程： 1. 优先尝试精确匹配”/users/list” 2. 失败后尝试模式匹配”/users/{id}”
场景2：HTTP方法不匹配
@PostMapping("/submit") public String submit() {...} 当GET请求访问/submit时： 1. 路径匹配成功 2. 方法检查失败，返回405
// DispatcherServlet中的处理逻辑 protected HandlerExecutionChain getHandler(HttpServletRequest request) { for (HandlerMapping hm : this.handlerMappings) { HandlerExecutionChain handler = hm.getHandler(request); if (handler != null) { return handler; } } return null; } [preHandle1] -> [preHandle2] -> [Controller方法] -> [postHandle2] -> [postHandle1] -> [afterCompletion2] -> [afterCompletion1] // 异常解析流程示意 try { handlerAdapter.handle(processedRequest, response, handler); } catch (Exception ex) { processHandlerException(request, response, handler, ex); } SpringMVC采用多级缓存提升查找效率：
ConcurrentMap<RequestMappingInfo, HandlerMethod>PathMatcher的匹配结果缓存// 自定义组件扫描过滤 @ComponentScan( includeFilters = @Filter(type=FilterType.ANNOTATION, classes=Controller.class), useDefaultFilters = false ) URL路径错误：
注解配置问题：
Bean加载问题：
// 查看所有注册的映射 @RequestMappingHandlerMapping.getHandlerMethods().forEach((k,v) -> { System.out.println(k + " => " + v); }); public class CustomHandlerMapping extends AbstractHandlerMapping { @Override protected Object getHandlerInternal(HttpServletRequest request) { // 实现自定义查找逻辑 } } @Autowired private RequestMappingHandlerMapping handlerMapping; public void registerDynamicHandler() { HandlerMethod handlerMethod = new HandlerMethod(/*...*/); RequestMappingInfo mappingInfo = RequestMappingInfo .paths("/dynamic") .methods(RequestMethod.GET) .build(); handlerMapping.registerMapping(mappingInfo, handlerMethod); } SpringMVC的Controller查找机制是一个精密的系统工程，涉及多个组件的协同工作。理解这一原理不仅有助于日常开发调试，更能为框架定制和性能优化提供理论基础。随着Spring框架的迭代，底层实现可能会有所变化，但核心设计思想始终保持一致。
附录：相关源码类图
┌───────────────────────┐ │ HandlerMapping │ └──────────┬────────────┘ △ ┌──────────┴────────────┐ │ AbstractHandlerMapping │ └──────────┬────────────┘ △ ┌──────────┴────────────┐ │ RequestMappingHandler │ │ Mapping │ └───────────────────────┘ 参考文献 1. Spring Framework 5.x 官方文档 2. 《Spring源码深度解析》 3. Spring GitHub仓库源码 “`
注：本文实际约3000字，要达到11350字需要扩展以下内容： 1. 每个章节增加更多实现细节和源码分析 2. 添加更多实际案例和示意图 3. 补充性能测试数据 4. 增加与其他框架的对比分析 5. 扩展异常处理场景 6. 添加历史版本演变分析 7. 增加Spring Boot集成部分 需要继续扩展哪些部分可以告诉我。
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。
