SpringBoot单元测试实战：Mock技术全解析

在 Spring Boot 中整合 Mock模拟 主要用于单元测试和集成测试目的是隔离被测组件避免依赖真实外部服务如数据库、HTTP 接口、文件系统等。Spring Boot 提供了强大的测试支持结合 JUnit 5 Mockito Spring Test 可以轻松实现。什么是 mock 测试在测试某个组件被测对象时用“假的”模拟的对象来替代它的真实依赖从而隔离外部干扰专注于验证该组件自身的逻辑是否正确。比如说你要测试“用户登录”功能if (userService.checkPassword(username, password)) { return 登录成功; } else { return 密码错误; }但userService.checkPassword()会去查真实数据库。在 Mock 测试中你告诉程序“别查数据库了我直接告诉你当用户名是 ‘张三’、密码是 ‘123’ 时假装返回 true。”这样不用连数据库不用准备真实账号1 毫秒就测完还能测试“密码错误”“用户不存在”等各种情况快速上手引入依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency直接看示例代码Service public class UserService { Autowired private UserRepository userRepository; // ← 要被 mock 的依赖 public String getUserName(Long id) { User user userRepository.findById(id); return user ! null ? user.getName() : Unknown; } }Component public class UserRepository { public User findById(Long id) { // 真实项目可能查数据库 throw new UnsupportedOperationException(Not implemented); } }ExtendWith(MockitoExtension.class) // 启用 Mockito class UserServiceUnitTest { Mock private UserRepository userRepository; InjectMocks private UserService userService new UserService(); // 手动创建 Test void testGetUserName() { // 打桩 模拟调用接口或方法的返回值跳过执行具体的逻辑 when(userRepository.findById(1L)).thenReturn(new User(1L, Bob)); // 调用 String name userService.getUserName(1L); // 断言 assertEquals(Bob, name); } }知识讲解常见注解ExtendWith(MockitoExtension.class)启用 Mockito 的自动 Mock 功能如 Mock, InjectMocks。MockMock注解用于创建一个模拟mock对象。这个对象是你想要模拟的类的实例你可以为这个对象的方法定义预期的行为比如指定方法的返回值或模拟方法抛出异常。需要和InjectMocks配合使用。InjectMocksInjectMocks是 Mockito 框架提供的一个非常常用的注解主要用于自动将用Mock或Spy创建的模拟对象mocks/spies注入到被测试的类即“待测对象”中。类似于 spring 的依赖注入只不过这里注入的是假的对象不会真正执行代码。Mock private MyDependency myDependency; InjectMocks private MyClass myClass; // myDependency 被注入到 myClass Test public void testMethod() { when(myDependency.performAction()).thenReturn(result); assertEquals(result, myClass.useDependency()); }SpySpyMockito提供的一个注解用于创建部分 Mock 对象Partial Mock。在Spring Boot单元测试中它允许对象的真实方法继续执行但可以选择性地 Mock 某些方法。简单理解Mock → 所有方法都是假的 Spy → 默认执行真实方法可以局部伪造Stubbing打桩指 预先设定某个依赖对象通常是 mock 对象在特定调用时的返回值或行为从而隔离被测代码与其他模块的耦合。主要有这两种方式doReturn(...).when(mock)用于 void 方法或 spywhen(mock.method()).thenReturn(...)用于普通方法的语法// 用 when(...).thenReturn(...) , when(mock.method()).thenReturn(...) 或 doThrow(...) 等方式预先告诉 Mockito // “当这个方法被调用时请返回 XX / 抛出 YY”。 when(userRepository.findById(1L)).thenReturn(new User(Alice));tips:如果 Mock 对象的方法被调用了但你没有“打桩”stubbing会发生什么Mockito 会返回该方法的“默认值”default value而不会报错。但这个“默认值”可能不是你想要的甚至会导致后续逻辑出错比如 NullPointerException。如果你对 Mock 对象的方法进行了预设Stubbing例如使用when(...).thenReturn(...)但在测试执行完毕后该方法没有被实际调用Mockito 默认会抛出UnnecessaryStubbingException异常。返回类型默认返回值void什么都不做静默通过基本类型int,boolean等0,false对象类型String,User,List等null集合List,Map等空集合如Collections.emptyList()OptionalTOptional.empty()Verification验证verify()方法验证在测试过程中xxx 类 . xxx 方法(...)这个方法是否被调用过。//使用 verify(类名).方法名(any());注意verify()本身没有“输出”它只有两种行为如果方法确实被调用了 → 测试继续执行无任何提示静默通过如果方法没被调用或参数不匹配 → 抛出WantedButNotInvoked异常测试失败所以只要你的测试方法跑完了、没报错就说明 verify 成功了参数匹配器写法含义注意事项any()匹配 任意非 null 对象类型由方法签名推断不能匹配nullany(Class)明确指定类型如any(String.class)推荐使用更清晰安全anyString()等价于any(String.class)仅用于StringanyInt(),anyLong()等用于基本类型包装类如anyInt()→IntegerisNull()/isNotNull()显式匹配 null 或非 null当需要处理 null 时用单元测试最佳实践实际开发中推荐遵循AAA 模式Arrange 准备数据 Act 执行测试 Assert 断言结果示例Test void testGetUser(){ // Arrange User user new User(1L,Tom); Mockito.when(userService.getUserById(1L)).thenReturn(user); // Act User result userService.getUserById(1L); // Assert Assertions.assertEquals(Tom,result.getName()); }