Spring源码 第六篇：Spring 5 源码深度拆解：SpringMVC 全流程核心原理

引言

接下来基于 Spring 源码，主要介绍以下几个问题：

1. @EnableWebMvc到底干了什么？
2. 请求从浏览器进来，完整经过哪些组件？
3. HandlerMapping、HandlerAdapter、ViewResolver分别干嘛用？
4. 参数是怎么绑定到方法入参的？
5. 返回值是怎么变成 JSON / 页面 / 异常信息的？
6. 拦截器、异常处理器在源码中哪个节点执行？

一、核心前提：SpringMVC 整体架构

1. 一句话概括流程

浏览器请求 →DispatcherServlet分发 → 找到对应Controller方法 → 执行方法 → 处理返回值 → 响应给浏览器。

2. 九大核心组件（面试必背）

二、入口：@EnableWebMvc 源码解析

@EnableWebMvc是 JavaConfig 方式手动启用 SpringMVC 的注解，等价于 XML 中的<mvc:annotation-driven/>。

注意：Spring Boot 项目不推荐、也不需要加它。

@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.TYPE)@Documented@Import(DelegatingWebMvcConfiguration.class)public@interfaceEnableWebMvc{}

核心就是导入：DelegatingWebMvcConfiguration。

它会自动向容器注册：

• RequestMappingHandlerMapping
• RequestMappingHandlerAdapter
• ExceptionHandlerExceptionResolver
• 各种参数解析器、返回值处理器
• 消息转换器（MappingJackson2HttpMessageConverter）

一句话：@EnableWebMvc= 自动装配 SpringMVC 全套核心组件。

三、容器启动：SpringMVC 初始化流程

1. Tomcat 启动 → 加载 DispatcherServlet

DispatcherServlet本质是一个Servlet，生命周期：init()→service()→destroy()。

2. init 阶段核心：初始化九大组件

protectedvoidinitStrategies(ApplicationContextcontext){initMultipartResolver(context);// 文件上传initLocaleResolver(context);// 国际化initThemeResolver(context);initHandlerMappings(context);// 路由映射initHandlerAdapters(context);// 执行适配器initHandlerExceptionResolvers(context);// 异常处理initRequestToViewNameTranslator(context);initViewResolvers(context);// 视图解析initFlashMapManager(context);}

这就是 SpringMVC 启动时干的所有事。

四、请求执行全流程

五、核心方法doDispatch源码解析

doDispatch源码部分内容如下：

protectedvoiddoDispatch(HttpServletRequestrequest,HttpServletResponseresponse){HttpServletRequestprocessedRequest=request;HandlerExecutionChainmappedHandler=null;try{ModelAndViewmv=null;ExceptiondispatchException=null;try{// 1. 找到对应的处理器（Controller方法）mappedHandler=getHandler(processedRequest);// 2. 找到适配器HandlerAdapterha=getHandlerAdapter(mappedHandler.getHandler());// 3. 执行拦截器 preHandleif(!mappedHandler.applyPreHandle(processedRequest,response)){return;}// 4. 【真正调用Controller方法】mv=ha.handle(processedRequest,response,mappedHandler.getHandler());// 5. 执行拦截器 postHandlemappedHandler.applyPostHandle(processedRequest,response,mv);}catch(Exceptionex){dispatchException=ex;}// 6. 处理结果、渲染视图、异常处理processDispatchResult(processedRequest,response,mappedHandler,mv,dispatchException);}catch(Exceptionex){// 最终拦截器mappedHandler.triggerAfterCompletion(processedRequest,response,ex);}}

六、关键节点深度拆解

1. 根据 URL 找到 Controller 方法

流程图位置：doDispatch→1. getHandler(request)

• 所在类：org.springframework.web.servlet.DispatcherServlet
• 所在方法：doDispatch
• 核心代码：mappedHandler = getHandler(processedRequest);

核心实现：

• 遍历容器中所有HandlerMapping
• 由RequestMappingHandlerMapping负责匹配
• 建立并返回url→HandlerMethod的映射
• 封装为HandlerExecutionChain（包含所有拦截器）

2. 找到执行方法的适配器

流程图位置：doDispatch→2. getHandlerAdapter(handler)

• 所在类：DispatcherServlet
• 所在方法：doDispatch
• 核心代码：HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());

核心实现：

• 遍历所有HandlerAdapter
• 匹配到RequestMappingHandlerAdapter继承自AbstractHandlerMethodAdapter
• 用于统一执行@RequestMapping方法

3. 执行拦截器preHandle

流程图位置：doDispatch→3. 执行拦截器 preHandle

• 所在类：DispatcherServlet
• 所在方法：doDispatch
• 核心代码：

if(!mappedHandler.applyPreHandle(processedRequest,response)){return;}

实际执行类：HandlerExecutionChain

booleanapplyPreHandle(HttpServletRequestrequest,HttpServletResponseresponse)throwsException{for(inti=0;i<this.interceptors.size();i++){HandlerInterceptorinterceptor=this.interceptors.get(i);if(!interceptor.preHandle(request,response,this.handler)){triggerAfterCompletion(request,response,null);returnfalse;}this.interceptorIndex=i;}returntrue;}

关键点：任一拦截器返回false，直接中断请求，并执行已通过拦截器的afterCompletion。

4. 真正执行 Controller 方法

流程图位置：doDispatch→4. adapter.handle(…)

• 所在类：DispatcherServlet
• 所在方法：doDispatch
• 核心代码：mv = ha.handle(processedRequest, response, mappedHandler.getHandler());

实际执行类：RequestMappingHandlerAdapter

4.1 参数解析

调度入口：RequestMappingHandlerAdapter
执行类：ServletInvocableHandlerMethod

遍历所有参数解析器，处理：

• @RequestParam
• @PathVariable
• @RequestBody
• @RequestHeader
• ServletRequest/HttpServletResponse

4.2 反射执行目标方法

所在类：InvocableHandlerMethod
方法：doInvoke

returnmethod.invoke(getBean(),getArguments());

执行链路：

ha.handle() ↓ handleInternal() ↓ invokeHandlerMethod() ↓ invocableMethod.invokeAndHandle() ↓ invokeForRequest() ↓ 【doInvoke()】 ← 最终执行到这里 ↓ method.invoke(bean, args) → 反射调用Controller方法

5. 处理返回值（JSON / 视图）

流程图位置： 执行方法后 →5. 处理返回值

• 所在类：ServletInvocableHandlerMethod
• 方法：invokeAndHandle
• 核心组件：HandlerMethodReturnValueHandlerComposite

常见实现：

• RequestResponseBodyMethodProcessor：处理@ResponseBody→ JSON
• ViewNameMethodReturnValueHandler：处理字符串视图名
• ModelAndViewMethodReturnValueHandler：处理ModelAndView

6. 执行拦截器postHandle

流程图位置：doDispatch→6. 执行拦截器 postHandle

• 所在类：DispatcherServlet
• 所在方法：doDispatch
• 核心代码：mappedHandler.applyPostHandle(processedRequest, response, mv);

实际执行类：HandlerExecutionChain

voidapplyPostHandle(HttpServletRequestrequest,HttpServletResponseresponse,ModelAndViewmv)throwsException{for(inti=this.interceptors.size()-1;i>=0;i--){HandlerInterceptorinterceptor=this.interceptors.get(i);interceptor.postHandle(request,response,this.handler,mv);}}

注意：postHandle是逆序执行。

• preHandle：正序执行
• postHandle：逆序执行
• afterCompletion：逆序执行

7. 渲染视图

流程图位置：doDispatch→7. 渲染视图

• 所在类：DispatcherServlet
• 所在方法：processDispatchResult
• 核心代码：render(mv, request, response);

逻辑：

• 通过ViewResolver解析视图名得到View
• 执行view.render (model, request, response)
• 适用于 JSP/Thymeleaf/Freemarker 等模板

8. 执行拦截器afterCompletion

流程图位置：doDispatch→8. 执行拦截器 afterCompletion

• 所在类：DispatcherServlet
• 位置：doDispatch最终catch块
• 核心代码：mappedHandler.triggerAfterCompletion(processedRequest, response, ex);

实际执行类：HandlerExecutionChain

voidtriggerAfterCompletion(HttpServletRequestrequest,HttpServletResponseresponse,Exceptionex)throwsException{for(inti=this.interceptorIndex;i>=0;i--){HandlerInterceptorinterceptor=this.interceptors.get(i);interceptor.afterCompletion(request,response,this.handler,ex);}}

关键点：无论正常返回还是抛异常，一定执行。

七、高频面试题

1. SpringMVC 执行流程是什么？

   1. Tomcat 启动，初始化DispatcherServlet
   2. 加载 Spring 容器，注册所有 SpringMVC 组件
   3. 请求进入doDispatch
   4. 根据 URL 找到Controller方法
   5. 执行拦截器前置
   6. 参数解析 → 调用方法
   7. 处理返回值（JSON/视图）
   8. 执行拦截器后置
   9. 渲染/响应
   10. 最终拦截器

2. DispatcherServlet作用？
   答：统一入口，总调度，管理九大组件。

3. HandlerMapping和HandlerAdapter区别？
   答：Mapping负责找方法，Adapter负责执行方法。

4. @ResponseBody原理？
   答：返回值处理器 + JSON 消息转换器。

5. 拦截器和过滤器区别？

   • Filter：Servlet 规范，所有容器都支持，拦截所有请求。
   • Interceptor：SpringMVC 组件，能访问 Spring 容器。

6. 参数是如何注入的？
   答：ArgumentResolver链式解析。