news 2026/5/12 12:00:18

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
什么是 Spring MVC?从零讲透 Web 开发核心(附完整代码 + 避坑指南)

视频看了几百小时还迷糊?关注我,几分钟让你秒懂!


一、真实场景:你写的接口,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(如UserOrder
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?优势在哪?

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

✅ Spring MVC极大简化 Web 开发,避免重复造轮子!


八、注意事项总结 ⚠️

  1. @RestController = @Controller + @ResponseBody,返回值直接序列化。
  2. 路径变量用@PathVariable,请求参数用@RequestParam,JSON 体用@RequestBody
  3. Spring MVC 默认使用 Jackson 做 JSON 转换,确保类有 getter/setter。
  4. 不要手动创建 DispatcherServlet!Spring Boot 已自动配置。
  5. 静态资源(如 JS/CSS)放在resources/static/下,Spring MVC 会自动放行

九、结语

Spring MVC 不是“另一个框架”,而是Spring 生态中处理 Web 请求的标准方案。无论你是做传统页面渲染,还是现代 RESTful API,都离不开它。

理解它,你就掌握了 Java Web 开发的“任督二脉”!

视频看了几百小时还迷糊?关注我,几分钟让你秒懂!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/9 20:17:02

GLM-4.6V-Flash-WEB部署教程:Docker镜像拉取步骤

GLM-4.6V-Flash-WEB部署教程&#xff1a;Docker镜像拉取步骤 智谱最新开源&#xff0c;视觉大模型。 1. 引言 1.1 学习目标 本文将带你从零开始完成 GLM-4.6V-Flash-WEB 的本地化部署&#xff0c;涵盖 Docker 镜像拉取、环境配置、一键推理脚本使用以及网页/API 双模式调用。…

作者头像 李华
网站建设 2026/5/9 19:46:00

一键启动Qwen3-4B-Instruct-2507:AI对话服务零配置部署

一键启动Qwen3-4B-Instruct-2507&#xff1a;AI对话服务零配置部署 1. 引言&#xff1a;轻量级大模型的即用时代 随着AI技术向边缘端和中小规模应用场景渗透&#xff0c;开发者对高性能、低门槛、易部署的大模型需求日益增长。在这一背景下&#xff0c;Qwen3-4B-Instruct-250…

作者头像 李华
网站建设 2026/5/10 1:24:52

如何验证打码完整性?AI卫士双检机制部署建议

如何验证打码完整性&#xff1f;AI卫士双检机制部署建议 1. 背景与挑战&#xff1a;隐私保护中的“漏网之鱼” 在数字化时代&#xff0c;图像和视频内容的传播日益频繁&#xff0c;人脸信息作为敏感生物特征&#xff0c;极易在无意中被泄露。尤其是在多人合照、会议纪实、公共…

作者头像 李华
网站建设 2026/5/12 1:39:54

基于SpringBoot的高校疫情防控web系统毕设

博主介绍&#xff1a;✌ 专注于Java,python,✌关注✌私信我✌具体的问题&#xff0c;我会尽力帮助你。一、研究目的本研究旨在开发并实现一个基于SpringBoot的高校疫情防控Web系统&#xff0c;以满足当前疫情防控背景下高校管理工作的实际需求。具体研究目的如下&#xff1a;提…

作者头像 李华
网站建设 2026/5/10 5:32:11

工业温控系统中sbit变量的高效管理策略

工业温控系统中如何用好sbit&#xff1a;从代码细节到工程实践的深度指南在工业自动化现场&#xff0c;温度控制从来不是一件“调个PID就行”的简单事。一个看似普通的加热炉&#xff0c;背后可能是上百个传感器与执行器的协同运作——而在这套复杂系统的底层&#xff0c;真正决…

作者头像 李华