golang如何Mock外部HTTP调用_golang Mock外部HTTP调用总结-Golang-PHP中文网

httpmock 是拦截并返回预设响应最省事的方式，它无缝接管 http.DefaultClient 和自定义 client，无需改业务代码；需调用 httpmock.Activate() 启用、httpmock.DeactivateAndReset() 清理，否则请求照发或污染后续测试。

golang如何mock外部http调用_golang mock外部http调用总结

用 `httpmock` 拦截并返回预设响应最省事

Go 原生不提供 HTTP Mock 工具，但 httpmock 库能无缝接管 http.DefaultClient 和自定义 http.Client 的所有请求，无需改业务代码结构。它在测试中注册规则后，真实 HTTP 请求会被拦截，按 URL、方法、甚至请求体匹配并返回你设定的响应。

常见错误是忘记在测试开始前启用或结束时清理：httpmock.Activate() 必须调用，否则请求照常发出；测试末尾漏掉 httpmock.DeactivateAndReset() 会导致后续测试被污染。

安装：go get -u github.com/jarcoal/httpmock
基础用法：在 TestXxx 函数开头调用 httpmock.Activate()，结尾用 defer httpmock.DeactivateAndReset()
匹配 GET 请求：httpmock.RegisterResponder("GET", "https://api.example.com/users", httpmock.NewStringResponder(200, `{"id":1}`))
匹配带路径参数的请求可用正则：httpmock.RegisterResponder("GET", `^https://api\.example\.com/users/\d+$`, ...)

自己构造 `http.RoundTripper` 更轻量、更可控

如果只 mock 少量测试、不想引入第三方依赖，或者需要精确控制连接行为（比如模拟超时、重试失败），直接实现 http.RoundTripper 是更底层也更干净的方式。它绕过整个 client 配置链，直接替换 Transport 字段，对请求生命周期有完全掌控。

容易踩的坑是忽略 RoundTrip 方法必须返回非 nil 的 *http.Response 和 error —— Go 的 http.Transport 实现要求二者不能同时为 nil，否则 panic。

定义一个 struct 实现 RoundTrip(*http.Request) (*http.Response, error)
用 httptest.NewRecorder() 构造响应体，再包装成 *http.Response（注意设置 Body 字段为 io.ReadCloser）
赋值给 client：client.Transport = &myMockTransport{}
务必关闭响应体：resp.Body.Close() 在测试中要显式调用，否则可能泄漏 goroutine

`httptest.Server` 适合端到端逻辑验证，但别当 Mock 用

httptest.Server 启的是真实 HTTP 服务，监听本地端口，适合验证你的客户端是否正确拼接 URL、处理重定向、解析 Header 等完整流程。但它不是 Mock —— 它不拦截请求，而是让请求真正发出去并被自己接收，因此无法模拟网络错误、DNS 失败、TLS 握手超时等外部依赖问题。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

典型误用是把它当成“假 API”长期复用，结果测试变慢、端口冲突、或因并发没关 server 导致资源泄漏。

每个测试应独立启停：srv := httptest.NewServer(...); defer srv.Close()
URL 用 srv.URL 替代硬编码地址，避免端口冲突
若需返回不同状态码或 body，用 httptest.NewUnstartedServer + 手动配置 Handler
不适合高频调用场景：每次启动有毫秒级开销，大量测试会拖慢整体执行

别忘了 Context 超时和重试逻辑会影响 Mock 行为

很多 HTTP 客户端封装了基于 context.Context 的超时或重试，比如用 ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)。这时候即使你用 httpmock 返回得再快，测试也可能因上下文提前取消而失败——Mock 不会自动延长 context 生命周期。

同样，重试逻辑（如用 backoff.Retry）会让同一请求发多次，但默认 httpmock 规则只响应一次，第二次就会报错 “no responder found”。这往往让开发者误以为是网络问题。

测试含 timeout 的代码，务必用足够长的 context.WithTimeout，或直接传 context.Background()
需要多次响应同一 URL，用 httpmock.RegisterResponderRepeatedly 替代 RegisterResponder
检查业务代码里是否包裹了 http.DefaultClient 并覆盖了 Transport 或 Timeout，Mock 时要确保 client 实例被正确注入

Mock HTTP 的关键不在“怎么替”，而在“替完之后请求是否真走不到外网”——建议在测试里加一行 httpmock.IsActivated() 断言，或临时把 http.DefaultTransport 改成 panic 版本，确认没有漏网请求。