用 httptest.NewServer 可安全拦截并替换第三方 HTTP 调用,通过启动本地 mock 服务、动态注入 server.URL 到 client 配置,并在测试末尾调用 Close() 释放端口;需校验请求头、路径与方法,返回预设响应,避免真实外调。

用 httptest.NewServer 拦截并替换第三方 HTTP 调用
第三方 API 接口本质是 http.Client 发出的请求,测试时不能真发出去——得把它的目标地址换成一个本地可控的 mock server。最直接的办法是用 httptest.NewServer 启一个临时服务,再把被测代码里的 client.BaseURL 或 host 替成它返回的 URL。
常见错误现象:没改 client 地址,测试仍打到真实域名,导致超时、404 或污染外部环境;或忘记在 test 函数末尾调用 server.Close(),造成端口占用。
- 必须在测试开始前设置 client,例如:
client.BaseURL = server.URL(若用 resty)或http.DefaultClient.Transport = &http.Transport{...}(若用原生 http) - mock server 的 handler 里,用
c.Request.Method和c.Request.URL.Path区分不同接口行为 - 返回固定 JSON 时,用
c.JSON(200, yourMockData);模拟错误时,设状态码如c.String(500, "internal error") - 别在 handler 里用
time.Sleep模拟延迟——测试会变慢且不稳定;改用httptest.NewUnstartedServer+ 手动启动+关闭更可控
通过接口抽象 + gomock 隔离 HTTP 客户端依赖
硬编码 http.Get 或直接 new resty.Client 会让测试无法注入 mock。正确做法是定义一个 interface,比如 ThirdPartyClient,所有调用都走它,然后用 gomock 生成 mock 实现。
容易踩的坑:interface 定义在 service 层内部(如 type thirdPartyClient interface),mockgen 无法扫描到,导致生成失败;或方法签名带具体结构体(如 func GetUser(id int) (*User, error)),而非接收指针/接口,导致 mock 返回值绑定困难。
- interface 必须导出、定义在独立包(如
pkg/client),方法参数和返回值尽量用 interface 或基础类型 - 生成命令示例:
mockgen -source=client.go -destination=mock/client_mock.go -package=mock - 测试中调用
mockClient.EXPECT().GetUser(gomock.Eq(123)).Return(&User{Name: "test"}, nil) - 若第三方调用涉及重试、超时等逻辑,mock 方法里可调用
gomock.Any()匹配任意参数,专注验证行为而非细节
测试含中间件或鉴权头的第三方调用场景
很多第三方 API 要求 Authorization、X-Api-Key 等 header,而你的 service 层可能封装了自动加 header 的逻辑。测试时若只 mock 返回值,会漏掉 header 构造错误——比如拼错 token 前缀、漏传 timestamp。
关键点在于:mock server 的 handler 必须检查 c.Request.Header.Get("Authorization"),而不是只看路径和方法。
- 在 mock handler 里加断言:
if c.Request.Header.Get("Authorization") != "Bearer xyz" { c.AbortWithStatus(401); return } - 如果被测代码用
ctx.Value透传 token,测试前需手动塞:c.Set("api_token", "xyz"),再调用目标方法 - 不要用
assert.Equal直接比对整个req.Headermap——顺序不固定,改用assert.Contains检查关键 key-value 对 - 当第三方返回 429(rate limit)时,mock server 应返回对应 status + body,并验证 service 是否触发了退避逻辑(如重试次数、sleep 时间)
避免把单元测试写成集成测试的边界
mock 第三方接口的目标是「验证你调用它的逻辑是否正确」,不是「验证它本身是否可用」。一旦你在测试里启动 Redis、连真实数据库、或调用未 mock 的其他微服务,就跨过了单元测试的边界。
最容易被忽略的是隐式依赖:比如日志上报 SDK 内部悄悄发 HTTP 请求,或 metrics client 在 Record 时调用远程 endpoint。这些不会出现在函数签名里,但会在测试中突然失败。
- 所有外部 I/O(HTTP、DB、Redis、Kafka)都应通过 interface 抽象,并在测试中显式 mock
- 全局变量(如
logrus.StandardLogger()、prometheus.MustRegister)要在TestMain或每个 test 函数开头重置或替换 - 用
go list -f '{{.Deps}}' ./... | grep 'net/http'快速排查非预期的 HTTP 依赖 - 如果某个第三方 SDK 不提供 interface,只能 wrap 一层——哪怕只是转发,也要把它变成可 mock 的依赖


















