Golang中如何对有网络I/O的函数进行离线测试？httptest库模拟【实战】-Golang-PHP中文网

httptest.newserver 用于启动内存 http 服务拦截被测代码的真实请求，需将 base url 设为可注入参数；httptest.newrecorder 仅用于直接测试 handler，不走网络。

golang中如何对有网络i/o的函数进行离线测试？httptest库模拟【实战】

用 `httptest.NewServer` 拦截真实 HTTP 请求，而不是 mock 客户端

Go 标准库的 httptest 不是用来 mock http.Client 的，而是通过启动一个真实但内存中的 HTTP 服务来接管被测函数发起的请求。关键在于：让被测代码把请求发给 httptest.Server.URL，而不是硬编码的线上地址。

常见错误是试图 patch http.DefaultClient 或重写 Do 方法——这既难维护又容易漏掉超时、重定向等细节。正确做法是把依赖的 base URL 抽成参数或配置项：

被测函数接收 baseURL string（比如调第三方 API 的入口）
测试时传入 server.URL（如 "http://127.0.0.1:34212"）
确保被测逻辑中所有 http.NewRequest 都基于该 URL 构造路径

用 `httptest.NewRecorder` 测试 handler 本身，不是测试调用方

如果你在测的是自己写的 HTTP handler（比如 func(w http.ResponseWriter, r *http.Request)），那就直接用 httptest.NewRecorder 构造响应对象，再传给 handler 调用即可。它不走网络，纯内存模拟。

注意别混淆场景：前者是“我调别人”，后者是“别人调我”。典型误用是给 handler 测试也起 NewServer——完全没必要，还引入了不必要的 goroutine 和端口绑定开销。

req := httptest.NewRequest("GET", "/api/user/123", nil)
w := httptest.NewRecorder()
myHandler(w, req) —— 直接调用，无网络
检查 w.Code 和 w.Body.String()

处理重定向、超时、TLS 等真实行为必须靠 `NewServer`

如果被测函数内部用了 http.Client 并设置了 Timeout、CheckRedirect、甚至自定义 Transport，那只有 httptest.NewServer 能完整复现这些行为。因为它是真 HTTP 服务，会按标准流程响应状态码、Header、Body，也会触发重定向跳转、超时中断等。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

例如：你设了 client.CheckRedirect = func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse }，那么当 httptest.Server 返回 302 时，这个回调就会被调用——mock 出来的 fake client 很难精确模拟这种控制流。

server := httptest.NewServer(http.HandlerFunc(...)) 可以返回任意 status、header、body
记得 defer server.Close()，否则端口泄漏
若需 TLS，用 httptest.NewUnstartedServer + 手动 StartTLS()

不要在测试里拼接 URL 字符串，用 `url.JoinPath` 或 `fmt.Sprintf` 统一构造

离线测试失败最常见的原因是 URL 构造不一致：生产环境用 "https://api.example.com/v1"，测试却写了 "http://127.0.0.1:12345/v1/"（多了一个尾部 /），导致路径错位。Go 1.19+ 推荐用 url.JoinPath，它自动处理斜杠合并。

另外，避免在测试中写死端口号（如 "http://localhost:8080"），全部从 server.URL 获取，因为 httptest.NewServer 分配的是随机空闲端口。