使用 @webmvctest 测试控制器的核心做法是启用 spring mvc 的自动配置切片,从而在内存中启动一个轻量级的 web 环境。你只需将控制器类交给 spring 管理,并手动注入或 mock 依赖的服务层,即可通过 mockmvc 对象发起 http 请求并验证响应状态、json 内容或重定向行为。

如何配置切片以隔离控制器与完整应用上下文
配置的关键在于利用 @AutoConfigureMockMvc 注解自动获取 MockMvc 实例,并通过 @Import 或组件扫描仅加载目标控制器及其直接依赖。这样做可以显著减少测试启动时间,避免加载数据库连接、消息队列等重型基础设施。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.bean.MockBean;
import org.springframework.test.web.servlet.MockMvc;
import static org.mockito.BDDMockito.given;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
@WebMvcTest(UserController.class)
class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@MockBean
private UserService userService;
@Test
void shouldReturnUserWhenFound() throws Exception {
given(userService.findById(1L)).willReturn(new User(1L, "Alice"));
mockMvc.perform(get("/users/1"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.name").value("Alice"));
}
}
如何处理服务层的依赖注入与 Mock 行为
在切片测试中,服务层通常不是真实实现,而是被替换为 Mock 对象。使用 @MockBean 注解可以将现有的服务 Bean 替换为 Mockito 生成的代理,允许你在测试中定义特定的返回数据或异常行为,确保控制器逻辑的测试不受外部系统影响。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.bean.MockBean;
import org.springframework.test.web.servlet.MockMvc;
import static org.mockito.BDDMockito.willThrow;
import static org.springframework.http.HttpStatus.NOT_FOUND;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@WebMvcTest(UserController.class)
class UserControllerErrorHandlingTest {
@Autowired
private MockMvc mockMvc;
@MockBean
private UserService userService;
@Test
void shouldReturn404WhenUserNotFound() throws Exception {
willThrow(new RuntimeException("User not found"))
.given(userService).findById(999L);
mockMvc.perform(get("/users/999"))
.andExpect(status().isNotFound());
}
}
当服务抛出异常时控制器会返回什么状态码
如果服务层抛出未捕获的异常,Spring MVC 默认会根据全局异常处理器(如 @ControllerAdvice)的行为来响应。在没有自定义处理器的情况下,它通常会返回 500 Internal Server Error;若配置了针对特定异常的映射,则可能返回 400 或 404 等状态码,具体取决于异常类型和映射规则。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










