Spring MVC 基础

1. Spring MVC 是什么#

基于 Servlet 规范的 Web 层框架（不是 Servlet 替代品），在 Servlet 容器（Tomcat、Jetty 等）之上工作：

传统 Servlet 要手写 doGet/doPost、自己解析参数、自己写 JSON；MVC 用注解声明映射，由框架完成大部分样板代码。

2. 日常开发三层：Controller → Service → Mapper#

1
@RestController
2
@RequestMapping("/api/orders")
3
public class OrderController {
4
    private final OrderService orderService;
5

6
    public OrderController(OrderService orderService) {
7
        this.orderService = orderService;
8
    }
9

10
    @PostMapping
11
    public OrderVO create(@RequestBody @Valid CreateOrderRequest req) {
12
        return orderService.create(req);
13
    }
14
}
15

16
@Service
17
public class OrderService {
18
    @Transactional
19
    public OrderVO create(CreateOrderRequest req) {
20
        // 业务 + 调 Mapper
21
    }
22
}

各层 Bean 由容器注入（推荐构造器注入）。
→ 注入 IoC 篇 · 事务 AOP 篇 · MyBatis Mapper 与 XML

分层原则：Controller 薄、Service 厚；事务标在 Service 的 public 方法上，不要标在 Controller。

3. 核心组件#

REST 项目里，ViewResolver 用得少，HttpMessageConverter（Jackson）负责把返回值序列化成 JSON。

4. 请求处理流程#

1
Client 发 HTTP 请求
2
  → Servlet 容器（Tomcat）
3
  → Filter 链（编码、安全等，可选）
4
  → DispatcherServlet
5
  → HandlerMapping：匹配 @GetMapping 等方法
6
  → HandlerInterceptor.preHandle（可选）
7
  → HandlerAdapter：调用 Controller 方法
8
  → Controller → Service → Mapper
9
  → 返回对象或 ModelAndView
10
  → HttpMessageConverter 写 JSON（@ResponseBody / @RestController）
11
  → HandlerInterceptor.postHandle / afterCompletion
12
  → 响应返回 Client

记忆口诀：一进（DispatcherServlet）二找（Mapping）三调（Adapter）四转（Converter/View）。

与 IoC 的关系：上述组件本身也是 Spring 容器里的 Bean；Boot 通过自动配置注册 DispatcherServlet 和默认 HandlerMapping。

5. 常用注解#

类级别

方法级别映射（Boot 里常用语义化子注解）

参数绑定

校验与响应

1
@GetMapping("/{id}")
2
public UserVO get(@PathVariable Long id,
3
                  @RequestParam(defaultValue = "false") boolean detail) {
4
    return userService.find(id, detail);
5
}

6. REST API vs 传统 MVC 视图#

当前 Java 后端项目以 REST + JSON 为主；面试仍可能问 ModelAndView 和视图解析，知道即可。

7. Spring MVC 与 Spring Boot Web#

Spring Boot 的 spring-boot-starter-web 引入 spring-webmvc，并自动配置：

• 内嵌 Tomcat（或换 Jetty/Undertow）
• DispatcherServlet 与默认 HandlerMapping
• Jackson HttpMessageConverter
• 静态资源、application.properties 里的 server.port 等

本质仍是 Spring MVC，只是省掉 XML 和 web.xml 里手动注册 Servlet 的步骤。Web 层进阶（全局异常、Actuator）→ Spring Boot Web、运维与测试。

8. Spring、Spring Boot、Spring Cloud 关系#

Boot 可单独做单体或单个微服务；Cloud 建立在 Boot 之上，解决多服务协作。学 MVC 属于 Framework 层，Boot 只是启动与配置方式更简单。

1. Controller 里写事务或复杂业务#

@Transactional 标在 Controller 上虽可能生效，但事务边界应放在 Service，便于复用和测试，也避免 Web 层逻辑渗进业务。

2. GET 请求带 @RequestBody#

HTTP 规范不禁止，但网关、缓存、部分客户端对 GET body 支持差；查询用 Query/Path，改改用 POST 或 RESTful 设计。

3. 路径变量名与参数名不一致未指定#

@PathVariable 默认按参数名匹配；不一致时需 @PathVariable("userId") Long id。

4. 返回 Entity 直接暴露给前端#

应返回 VO/DTO，避免把数据库实体、懒加载字段、敏感字段直接序列化到 JSON。

5. 混淆 @Controller 与 @RestController#

@Controller 返回 "index" 会被当成视图名；REST 接口误用会导致 404 视图而不是 JSON。API 统一用 @RestController。

6. 忽略 404/405 是 Mapping 问题#

404 常是 URL 或 HTTP 方法未匹配到 @XxxMapping；检查类上 @RequestMapping 前缀、是否多写了 /、是否被 context-path 影响。