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;
       }
   }

运行：@SpringBootApplication 主类，访问 /api/books。

8. 性能优化与最佳实践

性能：使用缓存（@Cacheable）、异步（@Async）、虚拟线程（spring.threads.virtual.enabled=true）。
安全：集成 Spring Security，避免 SQL 注入。
测试：MockMvc 或 WebTestClient。
常见问题：404（检查映射）、参数绑定失败（用 @Valid）。
学习资源：推荐书籍如《Spring Start Here》（2025 版）；官方教程。

Spring MVC 是 Java Web 开发的基石，结合 Spring Boot 可快速构建生产级应用。如果你需要具体代码仓库、某个组件深入剖析或 2026 新特性 demo，继续问！

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