本文介绍在 Go 测试中使用 Gock 模拟异步 HTTP 请求时避免数据竞争（data race）的正确实践，重点解决 gock.New() 与 http.Client.send() 在 goroutine 中并发调用引发的竞态问题。
本文介绍在 go 单元测试中使用 gock 模拟异步 http 请求时避免数据竞争（data race）的正确实践，重点解决 `gock.new()` 与 `http.client.send()` 在 goroutine 中并发调用引发的竞态问题。
在 Go 测试中，Gock 是一个轻量、易用的 HTTP mock 库，常用于拦截和断言 HTTP 请求。但当被测代码在 goroutine 中发起非阻塞 HTTP 调用（例如 go client.Post(...)）时，极易触发数据竞争：gock.New() 在测试主线程注册 mock 规则，而 http.Client.send() 可能在子 goroutine 中并发执行并尝试匹配规则——此时 Gock 的内部状态（如规则列表、匹配器锁）尚未同步保护，导致 go test -race 报告竞态警告。
根本原因在于：Gock 默认不是 goroutine-safe 的初始化方式。其 gock.New() 和请求匹配逻辑共享全局状态，若 mock 注册与实际请求在不同 goroutine 中交错执行，就会破坏状态一致性。
✅ 推荐解决方案是 统一生命周期管理 + 主动等待机制，而非在每个测试函数中零散调用 gock.New()。核心思路是：
- 使用
testing.TestMain集中初始化所有 mock 规则； - 确保所有 mock 在测试开始前就位（避免运行时动态注册）；
- 测试结束后，主动等待所有预期请求完成，再清理；
以下是完整、线程安全的实现模板：
func setup() {
// 预注册全部所需 mock（含异步调用目标）
gock.New("https://myapi.com").
Post("/").
Reply(200).
JSON(map[string]string{"status": "ok"})
// 可按需添加其他依赖服务 mock
gock.New("https://auth.example.com").
Get("/health").
Reply(204)
}
func cleanup() {
// 等待所有 mock 请求完成或超时，确保 goroutine 安全退出
const timeout = 10 * time.Second
ticker := time.NewTicker(100 * time.Millisecond)
defer ticker.Stop()
deadline := time.Now().Add(timeout)
for time.Now().Before(deadline) && gock.IsPending() {
<p>? <strong>关键注意事项：</strong></p>
- ❌ 不要在
TestXxx函数内调用gock.New()—— 这会引入竞态风险，尤其在t.Parallel()下； - ✅ 所有
gock.New()必须在TestMain.setup()中完成，确保「先注册、后并发触发」； - ⚠️
gock.Off()必须在TestMain中defer调用，防止多个测试包间 mock 冲突； - ?
cleanup()中的gock.IsPending()是诊断利器：它返回true表示仍有未匹配的 mock 规则，可用于发现漏测路径或异步逻辑缺陷； - ? 若需模拟失败场景（如超时、500 错误），直接在
setup()中为同一 URL 设置不同响应即可，Gock 会按注册顺序匹配（支持.Times(n)控制次数）。
该方案彻底规避了 http.Client.send() 与 gock.New() 的竞态窗口，同时保持测试清晰性与可维护性，是 Gock 在高并发测试场景下的最佳实践。
