测试替身是替代真实依赖的服务模拟手段，目的是让测试更可控、快速、稳定。它主要包括：1. 桩（stub）返回预设数据；2. 伪对象（fake）提供轻量实现如内存数据库；3. 模拟对象（mock）验证行为是否发生。在 golang 测试中使用 wiremock 可避免外部服务不稳定、调用成本高、响应数据不确定等问题。wiremock 是基于 http 的可编程“假后端”，支持定义请求匹配规则和响应行为，常用于集成测试，通过 docker 部署后，在测试前配置映射规则，测试代码中将请求指向 wiremock 地址，即可模拟第三方接口行为。测试结束后建议清理映射以避免干扰。相较其他工具，wiremock 更适合集成测试与跨语言协作，虽然需要额外进程，但灵活性强且功能全面。
在做 Golang 项目测试时，如果涉及到调用第三方服务（比如 HTTP 接口、RPC、数据库等），我们通常不希望在测试过程中真的去请求外部系统。这时候就需要使用“测试替身”工具来模拟这些依赖服务的行为。WireMock 是一个非常流行的 HTTP 服务模拟工具，虽然它是 Java 写的，但可以通过 Docker 快速部署，在 Golang 测试中也能很好使用。
什么是测试替身？为什么需要它？
所谓“测试替身”，就是替代真实依赖的一种手段，目的是让测试更可控、更快速、更稳定。常见的测试替身包括：
- 桩（Stub）：返回预设数据
- 伪对象（Fake）：轻量实现，如内存数据库
- 模拟对象（Mock）：验证行为是否发生
在集成测试或端到端测试中，当我们的服务要调用外部 API 或微服务时，使用测试替身可以避免以下问题：
立即学习“go语言免费学习笔记（深入）”；
- 外部服务不稳定或不可用
- 调用成本高（如收费接口）
- 响应数据不确定，影响测试结果一致性
WireMock 简介与使用场景
WireMock 是一个基于 HTTP 的服务模拟工具，支持定义请求匹配规则和响应行为。你可以把它理解为一个可编程的“假后端”。
它的典型使用方式是：
- 启动一个独立的 WireMock 服务（Docker 最方便）
- 在测试前通过 REST API 设置期望的请求/响应规则
- 测试代码中将实际请求指向这个 WireMock 地址
- 验证服务是否按预期调用并处理响应
举个例子：假设你的 Go 服务要调用 https://api.example.com/user 获取用户信息。你可以在 WireMock 中设置一个规则：当收到 /user?uid=123 请求时，返回 {"name": "Alice"}。
如何在 Golang 测试中使用 WireMock
准备工作
- 安装 Docker（用于运行 WireMock）
- 编写测试逻辑，构造 HTTP Client 指向 WireMock 的地址
启动 WireMock 可以这样：
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
docker run -d -p 8080:8080 rodolpheche/wiremock
然后你就可以通过 http://localhost:8080/__admin/mappings 来添加映射规则。
示例：模拟 GET 请求
比如你想模拟一个返回特定用户的 GET 请求：
{
"request": {
"method": "GET",
"urlPattern": "/user\?uid=\d+"
},
"response": {
"status": 200,
"body": "{"name": "Alice"}",
"headers": {
"Content-Type": "application/json"
}
}
}你可以用 curl 把这段 JSON 发送到 WireMock 的 admin 接口，让它生效。
然后在 Go 测试中，把请求地址改成 http://localhost:8080/user?uid=123，就能得到预设的响应了。
清理映射
为了避免不同测试用例之间互相干扰，建议每次测试前后清理掉所有映射：
curl -X POST http://localhost:8080/__admin/reset
其他替代方案简要对比
除了 WireMock，还有一些其他工具也可以用来模拟第三方服务：
- Gock：Go 原生的 HTTP mock 库，适合单元测试，不需要额外进程
- Testcontainers + WireMock：结合容器技术，自动化更强
- httptest（标准库）：适合小范围局部测试，灵活性有限
选择哪个工具取决于你的测试层级和需求：
| 工具 | 适用场景 | 是否需要外部进程 |
|---|---|---|
| WireMock | 集成测试、多语言共享模拟逻辑 | ✅ |
| Gock | 单元测试、纯 Go 项目 | ❌ |
| httptest | 简单本地测试 | ❌ |
小结
用 WireMock 来模拟第三方 HTTP 服务，是一种灵活又强大的方式，尤其适合做集成测试或者跨团队协作中的服务契约测试。虽然它不是 Go 原生的，但通过 Docker 使用起来也并不复杂。
基本上就这些。只要记住几个关键点：启动服务、配置映射、测试完清理，剩下的就看你怎么组合各种请求规则了。
