Spring Web MVC 入门秘籍：从概念到实践的快速通道-程序员充电站

Spring Web MVC 入门秘籍：从概念到实践的快速通道
（2025–2026 最新风格，最适合快速上手）

这是一份极简但完整的 Spring Web MVC 入门指南，目标是让你在最短时间内理解核心概念、搭建第一个项目，并写出能用的接口。

第一步：先搞清楚 Spring Web MVC 到底是什么

一句话定义：

Spring Web MVC 是 Spring 框架提供的基于 Servlet 的 Web 层 MVC 框架，目前仍然是 Java 后端最主流的 Web 开发技术栈之一。

核心思想：“请求 → 控制器 → 业务 → 视图/响应”

经典流程图（文字版）：

浏览器请求 → DispatcherServlet（前端控制器） ↓ HandlerMapping（找控制器方法） ↓ HandlerAdapter（执行控制器方法） ↓ Controller（你的 @RestController / @Controller） ↓ 返回 ModelAndView 或 ResponseEntity / @ResponseBody ↓ ViewResolver（视图解析）或直接写 JSON ↓ 响应给浏览器

第二步：最核心的 8 个概念（背下来就入门了）

序号	概念	通俗解释	对应注解/类	是否必会
1	DispatcherServlet	Spring MVC 的“大脑”，所有请求都先到它	web.xml 或 SpringBoot 自动配置	★★★★★
2	@Controller	声明这是一个控制器（返回视图）	@Controller	★★★★☆
3	@RestController	控制器 + 所有方法默认 @ResponseBody（返回 JSON）	@RestController	★★★★★
4	@RequestMapping	映射请求路径、方法（GET/POST 等）	@GetMapping / @PostMapping 等	★★★★★
5	@RequestParam	接收查询参数 / 表单参数	@RequestParam	★★★★☆
6	@PathVariable	接收 URL 路径中的变量	@PathVariable	★★★★☆
7	@RequestBody	接收 JSON 请求体	@RequestBody	★★★★★
8	Model / ModelAndView	向视图传递数据（传统视图用得多）	Model.addAttribute()	★★★☆☆

第三步：Spring Boot 项目快速搭建（推荐方式）

方式一：使用 Spring Initializr（最快）

打开：https://start.spring.io
选择：
- Project：Maven / Gradle
- Language：Java
- Spring Boot：3.3.x 或 3.4.x
- Dependencies：Spring Web
生成 → 解压 → 用 IDEA 打开

方式二：IDEA 直接创建

New Project → Spring Initializr → 选 Spring Web → Finish

第四步：第一个能跑的 Hello World（Restful 接口）

// HelloController.javaimportorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RequestParam;importorg.springframework.web.bind.annotation.RestController;@RestControllerpublicclassHelloController{@GetMapping("/hello")publicStringsayHello(@RequestParam(value="name",defaultValue="World")Stringname){return"Hello, "+name+"!";}@GetMapping("/user/{id}")publicStringgetUser(@PathVariableLongid){return"User ID: "+id;}}

访问：

http://localhost:8080/hello → Hello, World!
http://localhost:8080/hello?name=Tom → Hello, Tom!
http://localhost:8080/user/123 → User ID: 123

第五步：接收 JSON 参数（最常用场景）

// User.java（DTO）publicclassUser{privateLongid;privateStringusername;privateIntegerage;// getter / setter / toString}// Controller@PostMapping("/users")publicResponseEntity<User>createUser(@RequestBodyUseruser){// 模拟保存user.setId(100L);returnResponseEntity.ok(user);}

Postman 测试 body（raw json）：

{"username":"alice","age":25}

{"id":100,"username":"alice","age":25}

第六步：必会的高频注解组合速查表

场景	推荐写法	说明
GET 查询参数	`@GetMapping + @RequestParam`	查询字符串
GET 路径参数	`@GetMapping("/users/{id}") + @PathVariable`	RESTful 风格
POST JSON	`@PostMapping + @RequestBody`	最常见创建接口
PUT 更新	`@PutMapping + @RequestBody`	整体更新
PATCH 部分更新	`@PatchMapping + @RequestBody`	局部更新
DELETE	`@DeleteMapping("/users/{id}")`	删除资源
返回状态码 + 数据	`ResponseEntity.ok()`/`.created()`等	推荐方式
文件上传	`@PostMapping + @RequestPart("file") MultipartFile file`	上传场景

第七步：常见新手坑 & 解决方案

启动类没扫描到 Controller
确保启动类在根包下，或使用@ComponentScan("com.your.base.package")
@RequestBody 接收不到数据
检查 Content-Type 是否为application/json
检查 DTO 是否有无参构造 + getter/setter
返回 JSON 中字段为 null 不显示
默认不显示 null，可加@JsonInclude(Include.ALWAYS)
跨域问题（CORS）
最快解决：加@CrossOrigin或全局配置 CorsFilter