Golanghttptest.Server使用教程详解

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang模拟外部服务教程 httptest.Server使用详解》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

应使用 httptest.NewServer 启动模拟服务，它自动绑定随机端口、启动监听并提供可请求的 URL；避免硬编码地址或使用 NewUnstartedServer，需在测试末尾调用 Close() 防泄漏。

用 httptest.NewServer 启动模拟服务，不是 httptest.NewUnstartedServer

多数人想快速 mock 一个 HTTP 接口时，直接选 httptest.NewServer 就对了。它自动绑定随机空闲端口、启动 goroutine 监听，并返回 *httptest.Server 实例，.URL 字段就是可直接请求的地址（如 "http://127.0.0.1:34923"）。别用 NewUnstartedServer——它不监听，得手动 .Start()，还容易忘记清理，测试里基本没优势。

常见错误：在测试中硬编码 "http://localhost:8080"，导致并发测试冲突或端口占用失败。必须依赖 NewServer 动态分配端口。

• 每次调用 httptest.NewServer 都会开新端口，互不干扰
• 务必在测试末尾调用 server.Close()，否则 goroutine 和端口泄漏
• 如果需要复用同一 server 多次响应，用 server.URL 拼路径即可，不用自己解析 host/port

用 http.HandlerFunc 定制响应逻辑，避开中间件和路由框架

模拟外部服务的关键是控制响应体、状态码、header 和延迟，不是复刻它的路由结构。直接传入 http.HandlerFunc 最轻量，也最可控：

server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    if r.URL.Path == "/api/users" && r.Method == "GET" {
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(http.StatusOK)
        w.Write([]byte(`{"id": 123, "name": "alice"}`))
        return
    }
    w.WriteHeader(http.StatusNotFound)
}))

注意点：

• 不要在 handler 里 panic，会终止整个 test goroutine；用 w.WriteHeader + 显式错误响应更安全
• 若需校验请求内容（比如检查 Authorization header 或 JSON body），在 handler 内部读 r.Body 并断言，而不是靠外部工具
• 避免在 handler 中做耗时操作（如数据库调用）；真要模拟延迟，用 time.Sleep，但别超过 100ms，否则拖慢测试

测试客户端时替换 http.Client 的 Transport，而非改 URL

你的业务代码如果用了自定义 http.Client（比如设置了 timeout 或 retry），别去 patch 它的 BaseURL 或拼接字符串。正确做法是临时替换它的 Transport 为 &http.Transport{RoundTrip: ...}，或者更简单——直接把 server.URL 注入到客户端初始化逻辑中（例如通过构造函数参数或配置字段）。

典型错误场景：客户端硬编码了 "https://api.example.com"，测试时想 mock 却只能靠 net/http/httptest 拦截 DNS，这不可靠且难调试。

• 推荐方式：让客户端接受一个 baseURL string 参数，测试时传 server.URL
• 如果无法改客户端代码，可用 http.DefaultClient.Transport = &http.Transport{...}，但必须 defer 恢复原 transport，否则污染其他测试
• 不要用 os.Setenv 改环境变量来切换 endpoint——耦合重、难追踪、易漏恢复

处理重定向、超时、连接拒绝等边界情况要显式构造

httptest.Server 默认总是成功响应，但真实外部服务会出错。要测容错逻辑，就得主动制造这些状况：

• 模拟连接拒绝：不用 httptest.Server，改用 net.Listen("tcp", "127.0.0.1:0") 后立即 Close()，再把地址传给 client —— 此时 Do() 会返回 connection refused
• 模拟超时：handler 里 time.Sleep(2 * time.Second)，同时 client 设置 Timeout: 100 * time.Millisecond
• 模拟重定向：handler 返回 http.StatusMovedPermanently 并设 Location header；注意 client 是否启用了 CheckRedirect

这些 case 很容易被忽略，尤其超时和重定向逻辑常藏在 SDK 底层。不显式覆盖，就等于没测。

理论要掌握，实操不能落！以上关于《Golanghttptest.Server使用教程详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！