应使用 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)
}))注意点：
立即学习“go语言免费学习笔记（深入）”；
- 不要在 handler 里 panic，会终止整个 test goroutine；用
w.WriteHeader+ 显式错误响应更安全 - 若需校验请求内容（比如检查
Authorizationheader 或 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并设Locationheader；注意 client 是否启用了CheckRedirect
这些 case 很容易被忽略，尤其超时和重定向逻辑常藏在 SDK 底层。不显式覆盖，就等于没测。
