← 课程目录 🚀 从零到一
📐 学习维度 阶段4 · 第15章 Spring MVC + MyBatis 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

15.1 一次 HTTP 请求的旅程:DispatcherServlet

审校 2026-09-25 · 素材来源:SpringMVC入门(松哥)(底稿改写)、一线笔记
📑 本篇章节导航 (共7节,点击直达)
先把前置旅程补全流水线九大组件,重点记五个最小可跑示例异常与全局处理踩坑清单面试怎么问一句话总结

浏览器敲下一个地址按下回车,后端日志打出「订单创建成功」——中间这几十毫秒里,请求在你的 Spring MVC 里走了一条完整的流水线。面试问 MVC,本质就是让你带面试官走一遍这条流水线:从网关到 Controller 到返回 JSON,每一站是谁在干活。

先把前置旅程补全

请求没进你的代码之前已经跑了两程。第一程在网络层:DNS 解析、TCP 三次握手、TLS 握手(12.1 的两次握手),字节流才到达服务器。第二程在容器层:Tomcat 的 Connector 监听端口,解析出 HTTP 报文,交给 Servlet 容器(管理 Servlet 生命周期、把请求映射到 Servlet 的运行环境,如 Tomcat/Jetty)。

第三程才轮到主角:请求被派发给 DispatcherServlet(Spring MVC 的前端控制器,所有请求的唯一入口 Servlet)。它是在 web 场景下对「门面模式」的经典应用——不管你有多少 Controller,对外只有一个门。它继承自 FrameworkServlet,随第一个请求(或启动时按配置)初始化,初始化时干的最重要一件事,就是把 Spring 容器里的各路组件装配成自己的九大件。

容器层还有一个高频追问点:Tomcat 怎么处理并发?答案是一请求一工作线程(Worker Thread,Tomcat 线程池默认上限 200)——每个请求占一条线程从头跑到尾,这条线程也是后面 ThreadLocal、SecurityContext 能工作的前提(18.2 的安全上下文就存在这条线程上)。顺藤摸瓜就能理解两件事:为什么慢接口会拖垮线程池(200 条线程全阻塞在慢 SQL 上,后续请求排队超时);为什么虚拟线程(14.4)对 IO 密集的 Web 应用是质变——阻塞不再占用宝贵的平台线程。

流水线九大组件,重点记五个


① DispatcherServlet 收到请求
② HandlerMapping —— 按 URL 找到目标方法(哪个Controller的哪个方法)
③ HandlerAdapter —— 适配执行该方法(处理参数解析等差异)
④ Controller 方法执行,返回 ModelAndView(@RestController 直接返回对象)
⑤ HttpMessageConverter —— 对象序列化成 JSON 写出
⑥ ViewResolver 解析视图名 → View 渲染(前后端分离时跳过)
⑦ 响应写回 Tomcat → 网络返回

逐个展开值得品的三个。HandlerMapping(URL 到处理器的映射器)维护着一张「路径 → 方法」的路由表,启动扫描 @RequestMapping 时建好,运行期 O(1) 查表——所以 URL 变了不用改任何调度代码,注解即路由。HandlerAdapter(处理器适配器)存在的理由是历史包袱:处理器形态各异(注解方法、老式实现接口),适配器把这些差异吸收掉,让 DispatcherServlet 只面对统一接口——又一个适配器模式的教科书案例。HttpMessageConverter(消息转换器)负责对象和字节流的双向转换:返回对象时按 Accept 头选 Jackson 转 JSON,接收 @RequestBody 时反向解析。前后端分离项目里,它就是你天天打交道的「隐形序列化层」。

流程图里第⑥步的「前后端分离时跳过」值得多说两句,因为它是两代 MVC 的分水岭。老时代(服务端渲染):Controller 返回 ModelAndView——视图名加模型数据,ViewResolver 把逻辑名拼成 JSP 路径,View 渲染出 HTML 整页返回。新时代(前后端分离):@RestController 是 @Controller 加 @ResponseBody 的合体注解,返回值不走视图解析、直接交给消息转换器序列化 JSON——ViewResolver 和 View 两站整体下岗。但别以为它们彻底死了:内部管理系统的模板页、邮件渲染(thymeleaf 生成 HTML 邮件)仍在用老流水线,两套机制共存于同一个 DispatcherServlet,按返回类型自动分流。

参数解析也藏着一环常被追问的细节:@PathVariable、@RequestParam、@RequestBody 怎么各自生效?答案是 HandlerMethodArgumentResolver(参数解析器策略接口)——每个注解对应一个解析器实现,HandlerAdapter 执行方法前先遍历解析器把参数备齐。知道这一层,就能解释「为什么自定义个注解能自动注入当前登录用户」:写一个解析器,从 ThreadLocal 取出用户对象塞进参数位——18 章的安全集成、公司内部的框架封装,用的都是这个正规开口。

拦截器在这条流水线上有三个法定时点:preHandle(方法前,返回 false 直接短路)、postHandle(方法后、渲染前)、afterCompletion(完成后,类似 finally)。登录校验放 preHandle,响应包装放 postHandle,资源清理放 afterCompletion——三个时点各司其职,和 AOP 的环绕通知(13.3)是同一思想在不同粒度的实现。

最小可跑示例

一个能完整走通流水线的迷你应用:


@RestController
@RequestMapping("/order")
public class OrderController {
    @GetMapping("/{id}")
    public Order get(@PathVariable Long id) {
        return orderService.findById(id);  // 返回值交给转换器
    }
    @PostMapping
    public Order create(@RequestBody OrderDTO dto) {
        return orderService.create(dto);   // 请求体由转换器解析
    }
}

再配一个拦截器体验时点:


@Component
public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest req,
                             HttpServletResponse resp, Object handler) {
        String token = req.getHeader("Authorization");
        if (token == null) { resp.setStatus(401); return false; }
        return true;   // 放行进入 Controller
    }
}

curl 打一次 /order/1,在三个时点各加一行日志,控制台顺序即流水线顺序——比背十遍组件名都牢。

拦截器要生效还得注册一步——实现 WebMvcConfigurer(MVC 定制的正规扩展接口):


@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry reg) {
        reg.addInterceptor(authInterceptor)
           .addPathPatterns("/**")
           .excludePathPatterns("/login", "/public/**");
    }
}

注意 excludePathPatterns 的价值:放行清单写在这里,登录接口自己就不会被自己的鉴权拦住——「规则加白名单」是所有安全配置的通用形态,18.2 的 Security 放行清单同款思路。注册顺序即执行顺序,多个拦截器按注册先后嵌套执行,像洋葱一样一层包一层。

异常与全局处理

流水线上还有一位无名英雄:@ControllerAdvice(全局的控制器增强,兜住所有 Controller 的共性逻辑)。@ExceptionHandler(BizException.class) 方法统一处理业务异常转成错误 JSON,从此 Controller 里不再写 try-catch。它生效的原理依然是流水线:方法抛出的异常沿原路冒回 DispatcherServlet,被转交给 Advice 里的匹配方法处理——异常也走「路由」,这个设计很多人用三年都不知道。

全局异常处理的标准形状值得记一份,生产代码几乎照抄:业务异常返回明确错误码,未知异常返回「系统繁忙」并记日志(栈给开发看,不给前端看):


@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(BizException.class)
    public Result<Void> biz(BizException e) {
        return Result.fail(e.getCode(), e.getMessage());
    }
    @ExceptionHandler(Exception.class)
    public Result<Void> unknown(Exception e) {
        log.error("未捕获异常", e);
        return Result.fail(500, "系统繁忙,请稍后再试");
    }
}

参数校验的 BindException 也从这里统一转成 400 提示——@Valid 校验失败抛的异常同样走这条路,「校验、业务、未知」三类异常一个 Advice 全兜住,Controller 才真正干净。

踩坑清单

面试怎么问

一句话总结

Spring MVC = 一个 DispatcherServlet 门面 + 九大组件流水线——路由靠注解建表、执行靠适配器抹平差异、序列化靠转换器,拦截器与全局异常是在流水线上动土的两个合法入口。