当前位置：首页 > news >正文

手把手教会你写单元测试 —— 从“不敢测”到“测得爽”（Spring Boot + JUnit 5 实战）

news 2026/5/12 10:48:45

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！（发点评论可以给博主加热度哦）

一、真实痛点：为什么你总在逃避写单元测试？

“业务太复杂，不知道怎么测！”
“写了测试，改代码又要改测试，太麻烦！”
“跑一次测试要连数据库、启动 Spring，慢得像蜗牛！”
“测了也没用，线上照样出 bug！”

🚨其实，你不是不会写测试，而是没掌握“正确的姿势”！

本文将通过真实业务场景 + 正反案例对比，手把手教你写出快、准、稳的单元测试！

二、什么是单元测试？一句话讲透

单元测试 = 对一个“最小可测试单元”（通常是方法）进行隔离验证，确保它在各种输入下都能正确工作。

✅ 核心原则：

快：毫秒级执行，不依赖外部（DB、网络）；
隔离：只测目标方法，其他依赖全部 Mock；
可重复：每次运行结果一致；
全覆盖：正常流 + 异常流都要测。

三、反例警告：这些“伪测试”你一定写过！

❌ 反例 1：启动整个 Spring 容器（集成测试冒充单元测试）

@SpringBootTest // ←←← 错！这是集成测试！ class UserServiceTest { @Test void testRegister() { // 连了数据库、Redis、MQ... // 跑一次 10 秒，谁受得了？ } }

❌ 反例 2：只测 happy path（正常流程），不测异常

@Test void testAdd() { assertEquals(5, calculator.add(2, 3)); // 只测了正数 // 没测负数、零、溢出... }

❌ 反例 3：测试代码和业务代码强耦合

// 业务代码改了字段名，测试全红！ assertEquals("张三", user.getName());

💥 这些都不是真正的单元测试！

四、手把手实战：用 JUnit 5 + Mockito 写纯单元测试

场景：用户注册服务（含手机号校验）

1️⃣ 业务代码（待测试）

@Service public class UserService { private final UserRepository userRepository; private final SmsService smsService; public UserService(UserRepository userRepository, SmsService smsService) { this.userRepository = userRepository; this.smsService = smsService; } public User register(String phone, String name) { if (userRepository.existsByPhone(phone)) { throw new IllegalArgumentException("手机号已存在"); } if (!isValidPhone(phone)) { throw new IllegalArgumentException("手机号格式错误"); } User user = new User(phone, name); userRepository.save(user); smsService.sendWelcomeSms(phone); // 发欢迎短信 return user; } private boolean isValidPhone(String phone) { return phone != null && phone.matches("^1[3-9]\\d{9}$"); } }

2️⃣ 单元测试（纯内存，0 依赖）

import static org.mockito.Mockito.*; import static org.junit.jupiter.api.Assertions.*; @ExtendWith(MockitoExtension.class) // 启用 Mockito class UserServiceTest { @Mock private UserRepository userRepository; @Mock private SmsService smsService; @InjectMocks private UserService userService; // 自动注入 mock 依赖 @Test @DisplayName("注册成功：手机号合法且未注册") void shouldRegisterSuccessfully() { // Given（准备） String phone = "13800138000"; String name = "张三"; when(userRepository.existsByPhone(phone)).thenReturn(false); // When（执行） User result = userService.register(phone, name); // Then（断言） assertNotNull(result); assertEquals(phone, result.getPhone()); assertEquals(name, result.getName()); verify(userRepository).save(any(User.class)); // 验证 save 被调用 verify(smsService).sendWelcomeSms(phone); // 验证短信被发送 } @Test @DisplayName("注册失败：手机号已存在") void shouldThrowExceptionWhenPhoneExists() { // Given String phone = "13800138000"; when(userRepository.existsByPhone(phone)).thenReturn(true); // When & Then IllegalArgumentException ex = assertThrows( IllegalArgumentException.class, () -> userService.register(phone, "李四") ); assertEquals("手机号已存在", ex.getMessage()); verify(userRepository, never()).save(any()); // 确保没保存 verify(smsService, never()).sendWelcomeSms(any()); // 确保没发短信 } @Test @DisplayName("注册失败：手机号格式错误") void shouldThrowExceptionWhenPhoneInvalid() { // 测试多种非法手机号 assertInvalidPhone(null); assertInvalidPxone(""); assertInvalidPhone("123"); assertInvalidPhone("1380013800"); // 少一位 assertInvalidPhone("23800138000"); // 开头不是 1 } private void assertInvalidPhone(String phone) { IllegalArgumentException ex = assertThrows( IllegalArgumentException.class, () -> userService.register(phone, "王五") ); assertEquals("手机号格式错误", ex.getMessage()); } }

✅优势：

0 数据库：用@Mock模拟依赖；
毫秒级运行：整个测试类 < 100ms；
覆盖全面：成功 + 两种失败场景；
验证行为：不仅看返回值，还验证save和sendSms是否被正确调用。

五、关键工具介绍

注解/方法	作用
`@ExtendWith(MockitoExtension.class)`	启用 Mockito
`@Mock`	创建 mock 对象（模拟依赖）
`@InjectMocks`	创建被测对象，并自动注入 mock 依赖
`when(...).thenReturn(...)`	定义 mock 行为
`verify(...).method(...)`	验证方法是否被调用
`assertThrows`	断言抛出异常
`never()`	验证方法从未被调用

六、高级技巧：测试私有方法？别傻了！

很多新手问：“怎么测isValidPhone私有方法？”

✅正确答案：不要直接测私有方法！

私有方法是实现细节，应该通过公有方法间接测试；
如果私有方法逻辑复杂，说明它该提取成独立工具类！

// 提取成工具类（可单独测试） public class PhoneUtils { public static boolean isValid(String phone) { return phone != null && phone.matches("^1[3-9]\\d{9}$"); } } // 然后在 UserService 中调用 if (!PhoneUtils.isValid(phone)) { ... } // 单独测试 PhoneUtils class PhoneUtilsTest { @Test void testValidPhone() { ... } }

📌原则：测试行为，而不是实现！

七、集成测试 vs 单元测试 —— 别再混淆！

类型	注解	速度	用途
单元测试	`@ExtendWith(MockitoExtension.class)`	⚡ 毫秒级	测单个类逻辑
集成测试	`@SpringBootTest`	🐌 几秒~几十秒	测整个 Spring 上下文、DB 交互

✅建议比例：

单元测试：80%（快、稳、易维护）
集成测试：20%（验证关键链路）

八、完整项目结构（Maven）

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

默认包含：