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。它不是业务控制器,而是统一的前端控制器,负责协调后续组件并组织响应。

Spring MVC 请求处理链

核心组件如何协作

HandlerMapping 根据请求路径、HTTP 方法和注解元数据查找匹配的处理器方法。找到目标后,HandlerAdapter 负责以统一方式调用控制器,并在调用前完成参数解析、类型转换和数据绑定。

控制器返回 Java 对象时,RequestResponseBodyMethodProcessor 会结合内容协商选择合适的 HttpMessageConverter。在常见 REST 接口中,Jackson 转换器把对象序列化为 JSON,再由 DispatcherServlet 写回 HTTP 响应。

这条链路可概括为:先匹配处理器,再解析参数并调用方法,最后转换返回值。任何一个阶段失败,都会表现为不同的状态码和异常类型。

用最小应用验证请求链

下面代码可放入已经引入 spring-boot-starter-web 的 Spring Boot 3 项目中,作为完整启动类运行。控制器直接返回 Map,因此不会查找 HTML 模板,而是进入消息转换器。

java
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);
        }
    }
}

预期结果

text
应用启动后注册 GET /api/ping,请求返回 Content-Type: application/json。
启动日志中可看到 Started RequestFlowApplication in <TIME> seconds。

启动应用后执行以下命令;<PORT> 替换为实际监听端口,默认通常为 8080。

bash
curl -i "http://localhost:<PORT>/api/ping?name=Spring"

预期输出

text
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,则继续检查业务异常、序列化失败以及全局异常处理器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 Spring MVC 请求流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通