Java案例如何实现单元测试？

wen java案例 2026-06-08 54

Java单元测试实战：从入门到精通的核心案例解析

目录导读

为什么Java项目必须做单元测试？
单元测试框架选型：JUnit vs TestNG
Java单元测试经典案例（含代码）
模拟外部依赖：Mockito实战
常见问题问答（Q&A）
单元测试最佳实践与SEO优化建议

为什么Java项目必须做单元测试？

在Java开发中，单元测试是保证代码质量的第一道防线，根据Google的工程实践报告，经过充分单元测试的模块，线上故障率降低约68%，什么是单元测试？它是对程序中的最小可测试单元（通常是一个方法或类）进行正确性验证的过程。

Java案例如何实现单元测试？

核心价值：

快速发现逻辑错误，避免Bug流入集成测试
支持代码重构，无需担心破坏已有功能
作为活文档，清晰展示每个方法的输入输出预期

单元测试框架选型：JUnit vs TestNG

特性	JUnit 5	TestNG
学习曲线	简单，社区庞大	稍复杂，功能更全
注解支持	@Test, @BeforeEach, @ParameterizedTest	@Test, @BeforeMethod, @DataProvider
并行执行	原生支持	原生支持
适用场景	单体项目、Spring Boot	大型分布式系统、数据驱动测试

推荐：Spring Boot项目首选JUnit 5,结合Mockito。

Java单元测试经典案例（含代码）

案例：用户注册服务测试

假设我们有如下业务代码：

public class UserService {
    private UserRepository userRepository;
    public String registerUser(String username, String email) {
        if (username == null || username.isBlank()) {
            throw new IllegalArgumentException("用户名不能为空");
        }
        if (email == null || !email.contains("@")) {
            throw new IllegalArgumentException("邮箱格式错误");
        }
        User existingUser = userRepository.findByUsername(username);
        if (existingUser != null) {
            throw new RuntimeException("用户名已存在");
        }
        userRepository.save(new User(username, email));
        return "注册成功";
    }
}

编写单元测试（JUnit 5 + Mockito）

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.junit.jupiter.api.Assertions.*;
import static org.mockito.Mockito.*;
@ExtendWith(MockitoExtension.class)
public class UserServiceTest {
    @Mock
    private UserRepository userRepository;
    @InjectMocks
    private UserService userService;
    @Test
    void testRegisterUser_NullUsername_ThrowsException() {
        // 当用户名空时，应抛出异常
        Exception exception = assertThrows(IllegalArgumentException.class, 
            () -> userService.registerUser(null, "test@example.com"));
        assertTrue(exception.getMessage().contains("用户名不能为空"));
    }
    @Test
    void testRegisterUser_ValidUser_Success() {
        // 模拟数据库查询返回null（用户不存在）
        when(userRepository.findByUsername("newuser")).thenReturn(null);
        String result = userService.registerUser("newuser", "new@test.com");
        assertEquals("注册成功", result);
        verify(userRepository, times(1)).save(any(User.class));
    }
}

测试要点：

使用@Mock模拟外部依赖（数据库、API等）
使用@InjectMocks注入mock到被测试类
验证异常、正常结果、调用次数

模拟外部依赖：Mockito实战

进阶：参数化测试与Mock行为定制

@ParameterizedTest
@CsvSource({
    ", valid@email.com, 用户名不能为空",
    "'', valid@email.com, 用户名不能为空",
    "user, invalid-email, 邮箱格式错误",
    "user, user@, 邮箱格式错误"
})
void testRegisterUser_InvalidInput_ThrowsException(
        String username, String email, String expectedMessage) {
    Exception exception = assertThrows(IllegalArgumentException.class, 
        () -> userService.registerUser(username, email));
    assertTrue(exception.getMessage().contains(expectedMessage));
}

Mockito最佳实践：

使用when(...).thenReturn(...)定义返回值
使用verify()验证方法是否被调用，防止遗漏
使用doThrow()模拟异常抛出
避免过度Mock，优先测试纯逻辑

常见问题问答（Q&A）

Q1：单元测试应该覆盖哪些场景？

A：边界值（null、空字符串、最大值）、正常流（正确输入）、异常流（无效输入、数据库失败、网络超时），例如上述案例覆盖了用户名空、邮箱格式错误、用户已存在等场景。

Q2：如何处理数据库或外部API的依赖？

A：使用Mockito模拟依赖对象，不启动真实数据库，对于复杂集成，可以使用内存数据库（H2）或测试容器（Testcontainers）,但单元测试阶段应完全隔离外部资源。

Q3：测试覆盖率需要达到100%吗？

A：不需要，Google和Facebook的实践显示，70%-80%的行覆盖率是合理的，重点覆盖核心业务逻辑、复杂算法、边界值条件，100%覆盖可能导致测试过度关注琐碎代码（如getter/setter）,反而降低测试维护性。

Q4：Spring Boot项目如何测试Controller层？

A：使用@WebMvcTest配合MockMvc,模拟HTTP请求而不启动服务器：

@WebMvcTest(UserController.class)
class UserControllerTest {
    @Autowired private MockMvc mockMvc;
    @Test
    void testRegisterUser_ReturnsOk() throws Exception {
        mockMvc.perform(post("/users")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"username\":\"test\",\"email\":\"test@example.com\"}"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.message").value("注册成功"));
    }
}

单元测试最佳实践与SEO优化建议

技术实践

测试命名规范：testMethodName_Scenario_ExpectedResult（如testRegisterUser_EmptyUsername_ThrowsException）
一个方法只测试一个概念：避免在一个@test方法中测试多个分支
使用断言库：AssertJ提供更人性的断言语法
持续集成：将单元测试纳入GitHub Actions/Jenkins流水线，代码提交自动运行