第2章 主流Mock框架选型：Mockito、EasyMock、WireMock、Mountebank

在模块边界验证中，选择合适的Mock框架直接影响测试编写效率、可维护性和协议覆盖范围。本章从原理、实现流程、代码示例、调试部署、常见错误及性能稳定性五个维度，对Mockito、EasyMock、WireMock和Mountebank四个主流框架进行横向对比，并给出选型决策参考。

2.1 框架全景对比

2.2 核心实现流程与代码示例

2.2.1 Mockito – 基于动态代理的对象级Mock

原理：通过拦截方法调用并返回预设值，支持when().thenReturn()和verify()模式。

// 创建mock对象
UserService mockService = mock(UserService.class);

// 设定桩行为
when(mockService.findUserById(100)).thenReturn(new User("Alice"));

// 调用被测代码
String result = controller.getUserName(100);

// 验证交互
verify(mockService, times(1)).findUserById(100);

2.2.2 EasyMock – 录制-重放模式

原理：先录制期望调用，再切换到重放模式执行验证。

UserService mockService = createMock(UserService.class);

// 录制阶段
expect(mockService.findUserById(100)).andReturn(new User("Bob"));
replay(mockService);

// 执行
String result = controller.getUserName(100);

// 验证
verify(mockService);

2.2.3 WireMock – HTTP服务级Stub

原理：启动独立HTTP服务器，匹配请求URL/Header/Body并返回预定义的响应。

// 静态导入 stubFor, get, urlEqualTo, aResponse
stubFor(get(urlEqualTo("/api/user/100"))
    .willReturn(aResponse()
        .withStatus(200)
        .withHeader("Content-Type", "application/json")
        .withBody("{\"name\":\"Charlie\"}")));

// 实际HTTP请求通过 http://localhost:8080/api/user/100 发送

2.2.4 Mountebank – 多协议模拟服务器

原理：通过HTTP API创建imposter（模拟端点），支持HTTP、TCP、SMTP等协议，利用JSON定义stub行为。

# 通过REST API创建一个HTTP imposter
curl -X POST http://localhost:2525/imposters \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "http",
    "port": 9090,
    "stubs": [{
      "responses": [{
        "is": {
          "statusCode": 200,
          "headers": {"Content-Type": "application/json"},
          "body": "{\"name\":\"Dave\"}"
        }
      }],
      "predicates": [{
        "and": [
          {"equals": {"method": "GET"}},
          {"equals": {"path": "/api/user/100"}}
        ]
      }]
    }]
  }'

2.3 调试与部署要点

• Mockito / EasyMock：直接在单元测试IDE中调试，Mock对象默认不记录日志，可使用MockitoDebugger或EasyMock.checkOrder辅助。
• WireMock：启动时添加--verbose参数查看请求匹配日志；管理接口/__admin可查看当前stub和请求记录。
• Mountebank：设置环境变量MB_DEBUG=true输出详细日志；通过/imposters接口查询匹配历史。
• 部署建议：WireMock和Mountebank作为独立服务建议通过Docker容器运行，确保测试环境与CI/CD环境一致。

2.4 常见错误与避坑指南

2.5 性能与稳定性优化建议

• 单元测试级（Mockito / EasyMock）：避免对每个测试方法创建全局Mock，使用@Mock注解配合MockitoRule或EasyMockRunner减少重复初始化。
• 集成测试级（WireMock / Mountebank）：限制同时启动的模拟服务器数量，使用@ClassRule（JUnit4）或@BeforeAll（JUnit5）启动一次，所有测试复用。
• 高并发场景：WireMock和Mountebank支持多线程请求，但注意stub定义中的线程安全性，避免在响应中直接返回静态可变对象。
• 模拟服务器资源回收：每次测试套件结束后显式关闭（WireMock: stopServer(); Mountebank: DELETE /imposters/{port}），防止端口泄漏。

2.6 选型决策参考图

下方SVG展示了四个框架在测试层级和协议支持范围上的定位关系，帮助团队根据项目需求快速选型。