news 2026/6/14 0:53:54

什么是 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/6/10 21:18:26

打造隐私优先产品:AI人脸卫士前端集成实战案例

打造隐私优先产品&#xff1a;AI人脸卫士前端集成实战案例 1. 引言&#xff1a;当隐私保护遇上智能识别 1.1 业务场景与痛点分析 在社交媒体、云相册、在线协作平台等广泛应用中&#xff0c;用户频繁上传包含人物的照片。然而&#xff0c;未经脱敏处理的图像极易造成个人隐私…

作者头像 李华
网站建设 2026/6/13 13:26:12

1GB显存搞定32K长文处理:通义千问2.5-0.5B边缘计算实战

1GB显存搞定32K长文处理&#xff1a;通义千问2.5-0.5B边缘计算实战 在AI大模型日益庞大的今天&#xff0c;动辄数十GB显存需求的模型让普通开发者望而却步。然而&#xff0c;阿里推出的 Qwen2.5-0.5B-Instruct 模型却反其道而行之——仅需 1GB显存&#xff0c;即可实现 32K上下…

作者头像 李华
网站建设 2026/6/12 6:20:08

MediaPipe Pose入门必看:环境配置与首次检测

MediaPipe Pose入门必看&#xff1a;环境配置与首次检测 1. 引言 1.1 学习目标 本文旨在帮助开发者快速掌握 MediaPipe Pose 的本地化部署与基础使用&#xff0c;完成从环境搭建到首次人体骨骼关键点检测的全流程实践。通过本教程&#xff0c;你将学会&#xff1a; 如何配置…

作者头像 李华
网站建设 2026/6/9 23:32:55

Nodejs和vue的家庭成员亲子相册图片照片管理系统的设计与实现_

文章目录 系统设计目标技术架构核心功能模块安全与性能优化实现成果 --nodejs技术栈--结论源码文档获取/同行可拿货,招校园代理 &#xff1a;文章底部获取博主联系方式&#xff01; 系统设计目标 该系统旨在通过Node.js与Vue.js技术栈构建一个家庭亲子相册管理系统&#xff0c…

作者头像 李华
网站建设 2026/6/13 20:00:19

基于SpringBoot的高校毕业与学位资格审核系统毕设

博主介绍&#xff1a;✌ 专注于Java,python,✌关注✌私信我✌具体的问题&#xff0c;我会尽力帮助你。一、研究目的本研究旨在设计并实现一个基于SpringBoot的高校毕业与学位资格审核系统&#xff0c;以满足现代高校在学生毕业与学位资格审核过程中的需求。具体研究目的如下&am…

作者头像 李华