当前位置：首页 > news >正文

什么是 Spring MVC？从零讲透 Web 开发核心（附完整代码 + 避坑指南）

news 2026/5/11 22:15:51

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！

一、真实场景：你写的接口，Spring 到底做了什么？

你写了一个简单的接口：

@RestController public class UserController { @GetMapping("/user/{id}") public User getUser(@PathVariable Long id) { return new User(id, "张三"); } }

启动项目，浏览器访问http://localhost:8080/user/123，立刻返回 JSON：

{"id":123,"name":"张三"}

但你有没有想过：

路径/user/123是怎么匹配到getUser方法的？
{id}是怎么自动转成Long id的？
返回的User对象是怎么变成 JSON 的？
整个流程是谁在协调？

👉答案就是：Spring MVC！

二、Spring MVC 是什么？（通俗版）

Spring MVC 是 Spring 框架中专门用于构建 Web 应用的模块，它基于经典的“MVC 设计模式”，帮你自动处理 HTTP 请求、参数绑定、视图渲染等繁琐工作。

✅ 核心目标：

让你只关注业务逻辑（Controller 方法）
自动完成请求 → 方法调用 → 响应的全流程

三、MVC 是啥？为什么重要？

MVC =Model（模型） + View（视图） + Controller（控制器）

组件	职责	在 Spring Boot 中的表现
Model	数据载体	Java Bean（如`User`、`Order`）
View	展示层	Thymeleaf 模板 / 或直接返回 JSON（无 View）
Controller	控制器	`@RestController`或`@Controller`类

💡 在前后端分离时代，View 常被省略，Controller 直接返回 JSON（即 RESTful API），但底层仍是 Spring MVC 在驱动！

四、Spring MVC 的核心组件（架构图解）

浏览器 → DispatcherServlet → HandlerMapping → Controller → Service → DB ↑ ↓ HandlerAdapter ViewResolver（可选）

关键角色说明：

组件	作用
DispatcherServlet	前端控制器，所有请求的统一入口（本质是一个 Servlet！）
HandlerMapping	根据 URL 找到对应的 Controller 方法
HandlerAdapter	调用 Controller 方法，并处理参数/返回值
ViewResolver	（可选）将逻辑视图名转为实际页面（如`index.html`）
HttpMessageConverter	将对象 ↔ JSON/XML（如`@ResponseBody`依赖它）

🔥重点：DispatcherServlet 是 Spring MVC 的心脏！

五、动手实战：手写一个 Spring MVC 流程（Spring Boot 版）

1️⃣ 引入依赖（自动包含 Spring MVC）

<!-- pom.xml --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>

✅spring-boot-starter-web内部已包含spring-webmvc！

2️⃣ 编写 Model

// User.java public class User { private Long id; private String name; // 构造函数、getter/setter 省略（可用 Lombok） public User(Long id, String name) { this.id = id; this.name = name; } // getter... }

3️⃣ 编写 Controller（核心！）

// UserController.java @RestController @RequestMapping("/api") public class UserController { // GET /api/user/123 @GetMapping("/user/{id}") public User getUser(@PathVariable Long id) { System.out.println("收到请求，ID=" + id); return new User(id, "张三"); } // POST /api/user @PostMapping("/user") public String createUser(@RequestBody User user) { // 实际应调用 service 保存到 DB return "用户 " + user.getName() + " 创建成功！"; } }

4️⃣ 启动 & 测试

# 启动 mvn spring-boot:run # 测试 GET curl http://localhost:8080/api/user/123 # 测试 POST curl -X POST http://localhost:8080/api/user \ -H "Content-Type: application/json" \ -d '{"id":456,"name":"李四"}'

✅ 输出：

{"id":123,"name":"张三"}

用户 李四 创建成功！

🎯 这背后全是 Spring MVC 在默默工作！

六、反例警告 ❌ —— 新手常踩的坑

❌ 反例1：忘记加`@RequestBody`导致参数绑定失败

// 错误写法！ @PostMapping("/user") public String createUser(User user) { // 缺少 @RequestBody return "OK"; }

💥 结果：user对象所有字段为 null！
✅ 正确：JSON 请求体必须用@RequestBody标注。

❌ 反例2：混淆`@Controller`和`@RestController`

// 错误用法 @Controller public class BadController { @GetMapping("/test") public String test() { return "hello"; // 会被当作视图名！ } }

💥 结果：Spring 会去找templates/hello.html，找不到就 404！
✅ 正确：
返回 JSON → 用@RestController
返回页面 → 用@Controller+@ResponseBody（或配合 Thymeleaf）

❌ 反例3：路径重复导致映射冲突

@RestController public class AController { @GetMapping("/data") public String a() { return "A"; } } @RestController public class BController { @GetMapping("/data") public String b() { return "B"; } // 冲突！ }

💥 启动报错：Ambiguous mapping（映射不明确）
✅ 解决：确保每个 URL 唯一，或使用不同前缀（如/api/v1,/api/v2）

七、Spring MVC vs 原生 Servlet？优势在哪？

对比项	原生 Servlet	Spring MVC
参数获取	`request.getParameter("id")`	`@PathVariable Long id`
JSON 转换	手动用 Jackson	自动`@ResponseBody`
路由管理	手写 if-else 或 web.xml	注解`@GetMapping`
异常处理	try-catch	`@ControllerAdvice`全局处理
扩展性	难	拦截器、AOP、自定义转换器等