一、环境搭建与依赖管理

单元测试的基石在于构建隔离的测试环境，Mockito作为Java生态中最流行的Mock框架，其核心依赖需通过构建工具精准引入。

1.1 基础依赖配置

对于Maven项目，需在pom.xml的<dependencies>节点中添加核心依赖：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>5.3.1</version> <!-- 建议使用最新稳定版 -->
    <scope>test</scope>
</dependency>

该依赖包含Mock对象创建、行为定义等基础功能，适用于JUnit4/5等测试框架。

1.2 JUnit5集成方案

针对JUnit5用户，推荐添加扩展模块以简化测试编写：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>5.3.1</version>
    <scope>test</scope>
</dependency>

该模块提供@ExtendWith(MockitoExtension.class)注解，可自动初始化Mock对象并支持依赖注入。

1.3 版本兼容性说明

Mockito 5.x系列要求Java 8+运行环境
与JUnit4配合使用时需额外引入mockito-inline依赖
避免混合使用不同主版本的Mockito（如3.x与5.x）

二、核心Mock技术解析

Mock对象的核心价值在于隔离被测代码与外部依赖，通过精准控制依赖行为来验证业务逻辑。

2.1 Mock对象创建

静态导入org.mockito.Mockito工具类后，可通过mock()方法快速创建对象：

// 创建List接口的Mock对象
List<String> mockedList = mock(List.class);
// 创建带泛型的Mock对象
Map<String, Integer> mockedMap = mock(Map.class);

对于final类、静态方法等特殊场景，需使用Mockito.mockStatic()或PowerMock等扩展工具。

2.2 行为定义范式

通过when().thenReturn()链式调用定义Mock对象的行为模式：

// 定义简单返回值
when(mockedList.get(0)).thenReturn("first");
// 链式调用配置
when(mockedList.size())
    .thenReturn(0)          // 第一次调用返回0
    .thenReturn(1);         // 后续调用返回1
// 参数匹配器使用
when(mockedList.get(anyInt()))
    .thenReturn("default"); // 匹配任意int参数

常用参数匹配器：

anyInt()/anyString()：匹配任意值
eq(value)：精确匹配特定值
argThat(predicate)：自定义匹配逻辑

2.3 交互验证机制

验证Mock对象的方法调用情况是确保测试完整性的关键：

// 精确验证调用次数
verify(mockedList, times(1)).get(0);
verify(mockedList, never()).clear();
// 范围验证
verify(mockedList, atLeastOnce()).add(anyString());
verify(mockedList, atMost(3)).size();
// 调用顺序验证
InOrder inOrder = inOrder(mockedList);
inOrder.verify(mockedList).add("A");
inOrder.verify(mockedList).add("B");

三、高级应用场景

掌握基础用法后，可通过以下技巧应对复杂测试场景。

3.1 异常模拟测试

验证代码对异常情况的处理能力：

// 模拟抛出运行时异常
when(mockedList.get(999))
    .thenThrow(new IndexOutOfBoundsException());
// 模拟检查型异常
doThrow(new IOException())
    .when(mockedInputStream).read(any(byte[].class));

3.2 部分Mock实现

对于需要保留部分真实逻辑的对象，可使用spy()创建部分Mock：

List<String> realList = new ArrayList<>();
List<String> spyList = spy(realList);
// 对特定方法进行Mock
doReturn("mocked").when(spyList).get(0);
// 其他方法保持真实实现
spyList.add("real"); // 实际执行ArrayList的add方法

3.3 异步测试支持

结合CompletableFuture测试异步调用：

ExecutorService executor = mock(ExecutorService.class);
when(executor.submit(any(Runnable.class)))
    .thenAnswer(invocation -> {
        Runnable task = invocation.getArgument(0);
        task.run(); // 立即执行而非异步
        return CompletableFuture.completedFuture(null);
    });

四、最佳实践建议

4.1 测试命名规范

采用methodName_ExpectedBehavior_WhenState格式：

@Test
void getUser_ShouldReturnNull_WhenUserNotFound() {
    // 测试实现
}

4.2 Mock对象复用策略

每个测试方法应创建独立的Mock实例
对于昂贵的资源（如数据库连接），可通过@BeforeEach初始化
避免在测试类中共享可变Mock对象

4.3 行为验证优先级

验证关键业务方法的调用
检查异常处理路径
确认边界条件处理
验证方法调用顺序（仅在必要时）

4.4 持续集成集成

在CI流水线中配置Mockito测试：

# 示例GitLab CI配置片段
test:
  stage: test
  script:
    - mvn clean test
    - ./generate-test-report.sh
  artifacts:
    reports:
      junit: target/surefire-reports/*.xml

五、常见问题解决方案

5.1 未预期的Null返回值

问题原因：未对Mock方法进行行为定义时，默认返回null。
解决方案：

// 错误示例
when(mockedList.get(0)).thenReturn(null); // 显式返回null
// 正确做法
when(mockedList.get(0)).thenThrow(new UnsupportedOperationException());
// 或定义实际业务需要的返回值

5.2 验证失败异常处理

当验证失败时，Mockito会抛出WantedButNotInvoked或TooManyActualInvocations异常。此时应：

检查测试方法是否执行了预期调用
确认Mock对象是否被意外修改
使用verifyNoMoreInteractions()检测意外调用

5.3 静态方法Mock限制

标准Mockito无法直接Mock静态方法，需采用以下方案：

升级到Mockito 5+并使用mockStatic
重构代码通过实例方法调用
使用PowerMock等扩展框架（不推荐新项目使用）

通过系统掌握这些技术要点和实践技巧，开发者能够构建出高覆盖率、强稳定性的单元测试体系，显著提升代码质量与交付效率。建议结合具体业务场景持续优化测试策略，形成适合团队的测试规范。

Mockito单元测试框架深度实践指南