Java 后端 / 系统课时
理解 Spring MVC 请求流程
理解 Spring MVC 请求流程
本课把一次 HTTP 请求从进入应用到返回 JSON 的全过程串起来。你将明确 DispatcherServlet 如何分派请求、HandlerMapping 如何定位控制器,以及消息转换器如何生成与视图无关的响应。
学习目标
- 说清 Spring MVC 请求链中各核心组件的职责
- 使用最小 Spring Boot 3 应用验证请求分派与 JSON 转换
- 按请求链顺序定位 404、参数转换和控制器异常
请求从 DispatcherServlet 进入
Spring Boot 引入 spring-boot-starter-web 后,会自动配置 Spring MVC。请求到达嵌入式 Servlet 容器后,通常先进入 DispatcherServlet。它不是业务控制器,而是统一的前端控制器,负责协调后续组件并组织响应。

核心组件如何协作
HandlerMapping 根据请求路径、HTTP 方法和注解元数据查找匹配的处理器方法。找到目标后,HandlerAdapter 负责以统一方式调用控制器,并在调用前完成参数解析、类型转换和数据绑定。
控制器返回 Java 对象时,RequestResponseBodyMethodProcessor 会结合内容协商选择合适的 HttpMessageConverter。在常见 REST 接口中,Jackson 转换器把对象序列化为 JSON,再由 DispatcherServlet 写回 HTTP 响应。
这条链路可概括为:先匹配处理器,再解析参数并调用方法,最后转换返回值。任何一个阶段失败,都会表现为不同的状态码和异常类型。
用最小应用验证请求链
下面代码可放入已经引入 spring-boot-starter-web 的 Spring Boot 3 项目中,作为完整启动类运行。控制器直接返回 Map,因此不会查找 HTML 模板,而是进入消息转换器。
package com.example.requestflow;
import java.util.Map;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
public class RequestFlowApplication {
public static void main(String[] args) {
SpringApplication.run(RequestFlowApplication.class, args);
}
@RestController
static class PingController {
@GetMapping("/api/ping")
Map<String, String> ping(
@RequestParam(defaultValue = "Anystack") String name) {
// 返回普通 Java 对象,由消息转换器序列化为 JSON
return Map.of("message", "pong", "name", name);
}
}
}预期结果
应用启动后注册 GET /api/ping,请求返回 Content-Type: application/json。
启动日志中可看到 Started RequestFlowApplication in <TIME> seconds。启动应用后执行以下命令;<PORT> 替换为实际监听端口,默认通常为 8080。
curl -i "http://localhost:<PORT>/api/ping?name=Spring"预期输出
HTTP/1.1 200
Content-Type: application/json
{"message":"pong","name":"Spring"}响应中的头字段顺序和附加字段可能因服务器配置不同而变化,但状态码、媒体类型和响应体应保持一致。
视图无关响应如何形成
@RestController 等价于在控制器类上同时使用 @Controller 与 @ResponseBody。返回值被当作响应体数据处理,而不是被解释为视图名称,因此 REST 接口不依赖 Thymeleaf、JSP 等模板引擎。
客户端的 Accept 请求头会参与内容协商。例如客户端接受 application/json,并且类路径中存在 Jackson 转换器时,Spring MVC 会选择 JSON 输出。若没有可写出目标类型的转换器,可能得到 406 Not Acceptable。
按链路定位常见故障
出现 404 Not Found 时,先检查请求路径、HTTP 方法、控制器包扫描范围和映射注解,因为问题通常发生在 HandlerMapping 阶段。出现 400 Bad Request 时,再检查参数名称、格式和类型转换。
出现 415 Unsupported Media Type 时,应核对请求的 Content-Type 与控制器 consumes 条件。控制器已经进入但返回 500 Internal Server Error,则继续检查业务异常、序列化失败以及全局异常处理器。