Java 后端 / 知识点

Spring Boot 开发速查手册

手册条目

使用 JUnit 和 Mockito 测试独立业务组件。

编写单元测试

用于测试不依赖 Spring 容器的业务组件。JUnit 负责组织测试和断言,Mockito 隔离数据库、远程接口等外部依赖,重点验证正常分支、异常分支以及依赖调用。

基本依赖

Spring Boot 项目通常引入测试启动器即可获得 JUnit Jupiter、Mockito 和 AssertJ。测试依赖限定为 test,避免进入生产运行时。

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

预期结果

text
依赖解析成功,测试代码可使用 JUnit Jupiter、Mockito 和 AssertJ。

主示例

服务负责校验用户名、规范化输入、阻止重复注册并返回新用户 ID。仓储属于边界依赖,单元测试只模拟它,不启动 Spring、数据库或网络。

java
package com.example.user;

import java.util.Locale;

public class UserService {

    private final UserRepository repository;

    public UserService(UserRepository repository) {
        this.repository = repository;
    }

    public long register(String rawName) {
        if (rawName == null || rawName.isBlank()) {
            throw new IllegalArgumentException("name must not be blank");
        }

        String name = rawName.trim().toLowerCase(Locale.ROOT);
        if (repository.existsByName(name)) {
            throw new IllegalStateException("name already exists");
        }
        return repository.save(name);
    }

    public interface UserRepository {
        boolean existsByName(String name);
        long save(String name);
    }
}

测试覆盖成功注册和重复名称两个核心行为,并检查重复名称时不会继续保存。

java
package com.example.user;

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

    @Mock
    private UserService.UserRepository repository;

    @Test
    void shouldNormalizeAndSaveName() {
        when(repository.existsByName("alice")).thenReturn(false);
        when(repository.save("alice")).thenReturn(1001L);

        UserService service = new UserService(repository);
        long userId = service.register(" Alice ");

        assertThat(userId).isEqualTo(1001L);
        verify(repository).existsByName("alice");
        verify(repository).save("alice");
    }

    @Test
    void shouldRejectDuplicateNameWithoutSaving() {
        when(repository.existsByName("alice")).thenReturn(true);

        UserService service = new UserService(repository);

        assertThatThrownBy(() -> service.register("alice"))
                .isInstanceOf(IllegalStateException.class)
                .hasMessage("name already exists");

        verify(repository).existsByName("alice");
        verify(repository, never()).save("alice");
    }
}

执行指定测试:

bash
./mvnw -Dtest=UserServiceTest test

预期输出

text
[INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

编写原则

每个测试只表达一个业务行为,通常按“准备数据、执行方法、验证结果”组织。返回值和异常使用断言校验;是否调用仓储、调用参数和调用次数使用 verify。

只模拟真正的边界依赖,例如 Repository、HTTP 客户端、消息发送器或时钟。实体、集合和字符串等简单对象直接创建,避免测试本身被 Mock 配置主导。

风险与边界

过度模拟会让测试在 SQL、序列化、事务或框架配置出错时仍然通过。此时应补充切片测试或集成测试,而不是继续增加 Mock。

宽泛使用 any()、lenient(),或者只断言“不抛异常”,容易掩盖错误参数。优先匹配关键实参,并同时验证返回值、异常类型和必要副作用。

排障清单

  • NullPointerException:确认使用了 @ExtendWith(MockitoExtension.class),或者在测试初始化阶段正确创建 Mockito Mock。
  • UnnecessaryStubbingException:删除当前用例没有实际消费的 when,不要用宽松模式掩盖多余 Stub。
  • Wanted but not invoked:检查被测对象是否持有同一个 Mock,以及测试是否真正进入预期分支。
  • 测试偶发失败:排查当前时间、随机数、线程调度和静态全局状态,优先注入 Clock、ID 生成器或可控执行器。

目录与阅读设置

记录一个想法

Spring Boot 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通