Spring MVC实战精要：从DispatcherServlet到Controller分层设计

1. 这不是又一个“Hello World”教程：Spring MVC到底在解决什么真实问题？

你点开这个标题，大概率不是因为想重温教科书里那个被写烂的 @Controller 加 @RequestMapping 组合。我带过六届校招实习生，也给三家公司做过内部技术培训，每次讲到Spring MVC，总有至少两个人在第三十分钟悄悄关掉页面——不是因为听不懂，而是因为 根本不知道自己为什么要学它 。他们看到的是 ModelAndView 、 DispatcherServlet 、 ViewResolver 这些词堆砌成的迷宫，却没人在意：为什么非得用这套东西？不用行不行？用别的框架（比如直接用Servlet）会死吗？

答案是：不会死，但会累死。Spring MVC解决的从来不是“能不能跑起来”的问题，而是“能不能在真实业务中活下来”的问题。举个最朴素的例子：你写一个用户注册接口，前端传来 username 、 email 、 password 、 confirmPassword 四个字段。用原生Servlet，你得手动从 request.getParameter() 里一个个取，再做空值判断、长度校验、邮箱格式正则匹配、两次密码一致性比对……最后拼HTML返回，或者手写JSON字符串塞进 response.getWriter() 。这还没算上异常处理、日志埋点、跨域配置、文件上传解析这些后续需求。

Spring MVC把这套流程拆解成可插拔的齿轮： @Valid 自动触发JSR-303校验， BindingResult 帮你收拢所有错误； @RequestBody 和 @ResponseBody 让JSON序列化/反序列化变成一行注解； HandlerExceptionResolver 统一拦截 NullPointerException 或自定义业务异常，返回标准化错误码； MultipartResolver 接管文件上传，连临时目录和大小限制都给你配好。它不创造新功能，而是把Java Web开发中那些重复了上千次的脏活、累活、易错活，封装成一套有共识、可复用、能演进的契约。

所以本篇不叫“Spring MVC入门”，而叫“Spring MVC实战切片”。我们不从 web.xml 配置开始，也不画UML时序图。我会带你从一个正在线上跑着的电商订单导出功能切入，看它是如何用 @ControllerAdvice 统一处理Excel生成失败、用 @ResponseStatus 精准控制HTTP状态码、用 ContentDisposition 头让浏览器正确识别下载文件名——这些代码就躺在我们生产环境的 OrderExportController.java 里，不是Demo，是每天被调用237次的真实逻辑。关键词里没有“基础”“入门”“初学”，因为真正的Spring MVC，从来不在概念里，而在你修复第17个 406 Not Acceptable 错误时改的那一行 produces = "application/vnd.ms-excel" 里。

2. DispatcherServlet：不是调度员，而是整个MVC世界的“宪法”

很多人把 DispatcherServlet 当成一个简单的请求分发器，就像公司前台把访客指到对应部门。这是最大的误解。它其实是整个Spring MVC架构的 宪法性存在 ——所有规则、所有流程、所有扩展点，都由它定义和执行。你写的每个 @Controller 、每个 @Service 、每个 @ExceptionHandler ，最终都要向它宣誓效忠。

它的核心机制是“责任链+策略模式”的混合体。当一个HTTP请求到达时， DispatcherServlet 不做任何具体业务处理，而是按固定顺序调用一系列 HandlerMapping 、 HandlerAdapter 、 HandlerExceptionResolver 等组件。这个顺序不是随意定的，而是Spring官方文档里白纸黑字写明的执行链（Execution Chain）。比如 HandlerMapping 负责根据URL找到哪个 @Controller 方法该执行，但它本身不执行；真正执行的是 HandlerAdapter ，它知道怎么调用 @RequestMapping 标注的方法，怎么注入 @PathVariable 参数，怎么处理 @ModelAttribute 。这种解耦让扩展变得极其简单：你想支持Kotlin协程？写个 CoroutineHandlerAdapter ；想集成GraphQL？搞个 GraphQlHandlerAdapter ——只要实现 HandlerAdapter 接口， DispatcherServlet 自然会把它纳入执行链。

这里有个关键细节常被忽略： DispatcherServlet 本身是个 HttpServlet ，但它 不直接继承 GenericServlet ，而是继承 FrameworkServlet 。后者才是真正的“弹簧”——它在 init() 方法里初始化 WebApplicationContext ，并把 ServletContext 、 ServletConfig 等容器上下文注入进去。这意味着 DispatcherServlet 的生命周期完全绑定在Servlet容器（Tomcat/Jetty）上，而它的子容器（WebApplicationContext）又管理着所有Spring Bean。这种双容器嵌套结构，就是Spring MVC能同时兼容Servlet规范和Spring生态的根本原因。

实操中我踩过最深的坑，是某次升级Spring Boot 2.7后， DispatcherServlet 的默认 dispatchOptionsRequest 属性从 true 变成 false 。结果前端发来的 OPTIONS 预检请求直接405，CORS配置全失效。查了三天才发现，这不是跨域配置问题，而是 DispatcherServlet 拒绝处理 OPTIONS 方法了。解决方案不是改CORS，而是在 application.properties 里显式加上 spring.mvc.dispatch-options-request=true 。这个例子说明：你永远不能把 DispatcherServlet 当成黑盒。它的每个布尔开关、每个List类型的属性（比如 handlerMappings ）、每个 init-param ，都可能成为线上故障的导火索。

提示：调试 DispatcherServlet 最有效的方法，是开启DEBUG日志。在 logback-spring.xml 里加一行 <logger name="org.springframework.web.servlet.DispatcherServlet" level="DEBUG"/> 。你会看到每一步执行的组件名称、耗时、甚至参数绑定详情。这不是为了炫技，而是当你遇到 404 却找不到Controller时，日志里那句 "No handler mapping found for HTTP request with URI [...]" ，比任何文档都管用。

3. Controller层设计：为什么你的@RestController总在“救火”，而不是“筑墙”？

翻看团队Git历史， UserController.java 的修改频率常年排前三。新增一个“重置密码邮件发送失败告警”要改，加个“手机号脱敏显示”要改，对接短信平台SDK版本升级又要改…… @RestController 像一块不断被焊补的铁板，越补越厚，越厚越脆。问题出在哪？不是代码写得不够好，而是 Controller层的职责边界被彻底模糊了 。

Spring MVC明确划分了三层职责：