Spring MVC 全面详解（Java 主流 Web 开发框架）

Spring MVC是Spring框架的核心Web模块，采用MVC模式，提供灵活的企业级Web开发方案。2026年主流版本为Spring Framework 7.0.x和Spring Boot 4.0.x，支持Java 25、Jakarta EE 11和AI集成。其核心优势包括依赖注入、灵活配置和强大扩展性，适用于REST API和企业应用开发。核心架构基于DispatcherServlet，通过

likuoelie

542人浏览 · 2026-01-30 10:22:43

likuoelie · 2026-01-30 10:22:43 发布

Spring MVC 全面详解（Java 主流 Web 开发框架）

以下是针对 Spring MVC 的全面详解（以 2026 年初主流 Java 生态为基准，基于 Spring Framework 7.0.x 和 Spring Boot 4.0.x）。Spring MVC 是 Spring 框架的核心 Web 模块，遵循 Model-View-Controller (MVC) 模式，提供灵活的 Web 应用开发解决方案。它是 Java 企业级开发的首选框架，支持 RESTful API、响应式编程，并与云原生环境无缝集成。内容基于官方文档和行业实践整理。

1. Spring MVC 概述

Spring MVC（全称 Spring Web MVC）是 Spring 框架的一部分，专为构建 Web 应用设计。它采用 前端控制器模式（Front Controller Pattern），通过 DispatcherServlet 统一处理请求，实现松耦合和高可扩展性。

核心优势：
- 依赖注入（DI）和控制反转（IoC）：简化组件管理。
- 灵活配置：支持注解、XML 和 Java 配置。
- 集成性强：无缝结合 Spring Boot、Spring Security、Spring Data 等。
- 性能优化：支持虚拟线程（Java 21+）、响应式 Web（WebFlux 替代品）。
- 适用场景：REST API、企业 Web 应用、微服务前端。
与 Spring Boot 的关系：2026 年，Spring Boot 4.0 是主流起点，它自动配置 Spring MVC，简化开发（无需手动 XML 配置）。
版本演进（2026 视角）：
- Spring Framework 7.0.x：支持 Jakarta EE 11、Java 25、AI 集成（Spring AI）。
- 生产推荐：Spring Boot 3.5.x（稳定版）或 4.0.x（前沿版）。

2. Spring MVC 架构

Spring MVC 基于 MVC 模式，将应用分为三层：

Model（模型）：数据层，封装业务数据（如 POJO、DTO）。
View（视图）：呈现层，渲染 HTML/JSON 等（如 JSP、Thymeleaf、Freemarker）。
Controller（控制器）：逻辑层，处理请求、调用服务、返回视图。

核心是 DispatcherServlet（前端控制器），它拦截所有请求，并分发到适当的组件。

架构图描述（文本简化版）：

客户端请求 → DispatcherServlet（前端控制器）
               ↓
HandlerMapping（映射处理器） → 找到 Controller
               ↓
Controller（业务逻辑） → 调用 Service → 返回 ModelAndView
               ↓
ViewResolver（视图解析器） → 渲染 View
               ↓
响应客户端（HTML/JSON）

关键设计原则：分离关注点（SoC）、开闭原则（OCP）。

3. 核心组件比较表

Spring MVC 的组件高度可配置，支持自定义扩展。

组件名称	作用	默认实现/示例	配置方式（注解优先）
DispatcherServlet	核心 servlet，处理所有请求	org.springframework.web.servlet.DispatcherServlet	web.xml 或 Spring Boot 自动配置
HandlerMapping	映射请求到控制器方法	RequestMappingHandlerMapping	@RequestMapping
HandlerAdapter	调用控制器方法	RequestMappingHandlerAdapter	自动配置
Controller	处理业务逻辑	@Controller / @RestController	@GetMapping / @PostMapping 等
ViewResolver	解析视图名称到实际视图	InternalResourceViewResolver	@Bean ViewResolver
ModelAndView	封装模型数据和视图	ModelAndView 对象	return new ModelAndView(“viewName”)
HandlerInterceptor	拦截请求（前/后/异常处理）	自定义实现 HandlerInterceptor	@Bean HandlerInterceptor
ExceptionResolver	处理异常	HandlerExceptionResolver	@ExceptionHandler
MultipartResolver	文件上传支持	CommonsMultipartResolver	@Bean MultipartResolver

@RestController：等价 @Controller + @ResponseBody，用于 REST API，返回 JSON 而非视图。

4. 请求处理流程（生命周期）

Spring MVC 的请求处理是一个完整的链路，涉及多个组件协作。

请求到达：浏览器/客户端发送 HTTP 请求。
DispatcherServlet 拦截：作为入口，初始化上下文。
HandlerMapping 匹配：根据 URL/方法/参数找到控制器方法。
HandlerAdapter 执行：调用控制器方法，注入参数（@RequestParam、@PathVariable 等）。
业务处理：控制器调用 Service/DAO，填充 Model。
返回 ModelAndView：指定视图和数据。
ViewResolver 解析：渲染视图（支持 JSON、XML、HTML）。
响应客户端：返回结果。
拦截器/异常处理：全程可拦截（如日志、安全检查）。

示例流程代码（简单 GET 请求）：

// Controller 示例
@RestController
@RequestMapping("/user")
public class UserController {
    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        // 模拟业务
        return new User(id, "张三");
    }
}

参数绑定：支持 @RequestBody（JSON 转对象）、@RequestHeader 等。
响应处理：默认 Jackson 序列化 JSON，支持自定义 Converter。

5. 配置方式

Spring MVC 支持三种配置模式，2026 年优先注解 + Java 配置。

注解配置（推荐）：

@Configuration
@EnableWebMvc  // 启用 MVC
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("index");
    }
}

XML 配置（遗留系统）：

<mvc:annotation-driven />
<context:component-scan base-package="com.example" />

Spring Boot 自动配置：application.yml 中配置（如 server.port=8080），无需手动 Servlet。

6. 高级特性

RESTful 支持：@GetMapping、@PostMapping、@PutMapping、@DeleteMapping。
异常处理：@ControllerAdvice + @ExceptionHandler 全局处理。
拦截器：用于日志、认证（如 JWT）。
文件上传/下载：@MultipartFile。
国际化（i18n）：MessageSource + LocaleResolver。
CORS 支持：@CrossOrigin。
响应式替代：Spring WebFlux（非阻塞，适用于高并发）。
2026 新特性：集成 Spring AI（智能路由）、Java 25 模块化支持、增强的安全（OAuth 3.0）。

7. 实战示例：简单 CRUD 应用

使用 Spring Boot 快速搭建。

依赖（pom.xml）：

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

控制器：

@RestController
@RequestMapping("/api/books")
public class BookController {
    private List<Book> books = new ArrayList<>();

    @PostMapping
    public Book addBook(@RequestBody Book book) {
        books.add(book);
        return book;
    }

    @GetMapping
    public List<Book> getAllBooks() {
        return books;
    }
}