1. Mock 技术选型原则：使用场景分析、工具对比与选型决策矩阵

在 API 接入测试体系中，Mock 网络请求是隔离被测系统与外部依赖的核心手段。选型不当会导致测试维护成本飙升、性能瓶颈频发，甚至遗漏关键异常场景。本章围绕什么场景必须 Mock、主流工具各有什么特性以及如何用决策矩阵快速选型三个问题展开，为后续 29 章的工程实践奠定工具选型基础。

1.1 使用场景分析

Mock 并非所有测试场景的必选项，但在以下四类场景中，合理的 Mock 策略能直接提升测试覆盖率与交付效率：

1.2 主流 Mock 工具对比

当前业界最成熟的三种 Mock 网络请求工具分别为 WireMock、MSW（Mock Service Worker） 与 MockServer。以下从实现原理、编程语言支持、性能与适用场景四个维度进行对比：

1.3 选型决策矩阵

基于实际项目经验，将选型条件归纳为四项关键指标：团队技术栈、性能要求、场景复杂度与可维护性。矩阵中每个单元推荐的工具组合可统一用于后续章节的实践参考：

决策流程可抽象为下方 SVG 框架图：从确定 Mock 需求出发，依次判断团队技术栈、性能要求与场景复杂度，最终收敛到推荐工具。

1.4 配套命令行与配置示例

在完成选型后，三款工具启动一个最小 Mock Server 的命令行或配置如下，供快速验证选型结果：

WireMock（独立 JAR 启动）

java -jar wiremock-standalone-3.3.1.jar --port 8089
# 在另一个终端添加 stub：
curl -X POST http://localhost:8089/__admin/mappings \
  -H "Content-Type: application/json" \
  -d '{"request":{"method":"GET","urlPath":"/api/user"},"response":{"status":200,"jsonBody":{"name":"alice"}}}'

MSW（Node.js 命令行）

npx msw init public/ --save
# 安装依赖后，测试文件中使用：
import { setupWorker, http, HttpResponse } from 'msw'
const worker = setupWorker(
  http.get('/api/user', () => {
    return HttpResponse.json({ name: 'alice' })
  })
)
worker.start()

MockServer（Docker 快速启动）

docker run -d --name mockserver -p 1080:1080 mockserver/mockserver:latest
# 使用 expect 添加预期：
curl -X PUT http://localhost:1080/mockserver/expectation \
  -H "Content-Type: application/json" \
  -d '{"httpRequest":{"method":"GET","path":"/api/user"},"httpResponse":{"statusCode":200,"body":{"name":"alice"}}}'