Spring Boot 虚拟 MVC 调用

概述

本文档详细讲解如何在 Spring Boot 项目中使用虚拟 MVC 调用技术进行接口测试。通过模拟 HTTP 请求环境，开发者可以在不启动真实服务器的情况下验证表现层接口的逻辑和响应。

环境搭建

1. 项目结构准备

java 复制代码

src
├── main
│   └── java
│       └── com.example.demo
│           ├── controller
│           │   └── BookController.java
│           └── service
│               └── BookService.java
└── test
    └── java
        └── com.example.demo
            └── BookControllerTest.java

2. 核心依赖

xml 复制代码

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

虚拟 MVC 调用实现

1. 启动虚拟环境

java 复制代码

@AutoConfigureMockMvc
public class BookControllerTest {
    @Autowired
    private MockMvc mockMvc;
}

2. 创建虚拟请求

java 复制代码

@Test
void testGetBook() throws Exception {
    mockMvc.perform(get("/books/1"))
           .andExpect(status().isOk())
           .andExpect(jsonPath("$.id").value(1));
}

3. 请求构建器模式

java 复制代码

MockHttpServletResponse response = mockMvc.perform(
    get("/books/1")
        .param("id", "1")
        .header("Authorization", "Bearer token")
)
    .andReturn()
    .getResponse();

请求模拟详解

1. 请求类型支持

请求类型	示例代码	说明
GET	`get("/books/1")`	获取资源
POST	`post("/books")`	创建资源
PUT	`put("/books/1")`	更新资源
DELETE	`delete("/books/1")`	删除资源

2. 参数传递方式

java 复制代码

// 查询参数
.get("/books")
.param("page", "1")
.param("size", "10")

// 请求头
.header("Content-Type", "application/json")

// 请求体
.content("{\"id\":1}")
.contentType(MediaType.APPLICATION_JSON)

验证与断言

1. 响应验证

java 复制代码

andExpect(status().is2xxSuccessful())
andExpect(jsonPath("$.name").value("Spring Boot"))
andExpect(header().exists("Content-Type"))

2. 异常处理

java 复制代码

@Test
void testInvalidId() throws Exception {
    mockMvc.perform(get("/books/0"))
           .andExpect(status().is4xxClientError());
}

最佳实践

1. 测试覆盖率建议

覆盖所有 HTTP 方法
验证正常流程和异常流程
检查响应头信息
验证数据格式（JSON/XML）

2. 常见问题

问题	解决方案
请求未被处理	检查请求路径是否匹配
响应不匹配	检查 JSONPath 表达式
端口冲突	使用随机端口配置
依赖缺失	确保 spring-boot-starter-test 依赖

补充说明

虚拟环境特性：
- 模拟完整的 HTTP 请求环境
- 支持所有标准 HTTP 方法
- 自动处理请求参数和头信息
- 提供完整的响应对象

与真实请求区别：

特性	虚拟调用	真实请求
端口	随机分配	固定配置
依赖	无需启动服务器	需要启动服务器
速度	更快	慢于本地调用
环境	完全隔离	实际部署环境

进阶用法：
- 使用 MockHttpServletRequest 自定义请求
- 通过 MockHttpServletResponse 获取响应内容
- 结合 Mockito 进行更复杂的断言

注意事项

所有测试类需添加 @AutoConfigureMockMvc 注解
使用 @Autowired 注入 MockMvc 对象
测试方法需声明 throws Exception
建议使用 @SpringBootTest 进行集成测试
对于复杂业务场景，建议结合 @MockBean 使用

通过以上实践，开发者可以高效地完成表现层接口的单元测试和集成测试，确保接口逻辑的正确性和稳定性。