httptest.server 是轻量 mock 最佳选择，无需真实端口或完整框架；用 http.handlerfunc 构建可控响应，配合 servemux 支持多路径与动态状态，避免全局变量和 defaultclient 副作用。
用 httptest.Server 做轻量 Mock，别碰完整 Web 框架
真要快速验证 API 调用逻辑，httptest.Server 是最直接的选择——它不启动真实端口、不依赖外部服务、测试完自动回收。你写一个 http.HandlerFunc，传给 httptest.NewServer，就能拿到一个可访问的 URL，比如 http://127.0.0.1:34212。
常见错误是试图在测试里跑 gin.Default() 或 echo.New()，结果引入路由冲突、中间件干扰、甚至测试间端口占用。Mock 的目标是「可控返回」，不是「模拟生产环境」。
- 返回固定 JSON：直接
w.Header().Set("Content-Type", "application/json")，然后json.NewEncoder(w).Encode(...) - 需要不同状态码？在 handler 里写
w.WriteHeader(http.StatusNotFound)，再写 body - 想模拟网络延迟？加
time.Sleep(200 * time.Millisecond)，比配 timeout 更贴近真实抖动 - 注意：每次调用
httptest.NewServer都会绑定新端口，别在全局变量里复用，也别手动指定端口
Mock 返回值要和实际结构一致，否则 json.Unmarshal 静默失败
Go 的 json 包遇到字段名不匹配、类型不兼容时，往往跳过赋值而不报错。你看到 struct 字段是零值，第一反应常是“没收到数据”，其实是结构体定义和 Mock 返回的 JSON 对不上。
典型场景：后端返回 {"user_id": 123}，你定义了 UserID int `json:"user_id"` —— 看似对，但如果 Mock 里误写成 "userId" 或 "id"，字段就空了。
立即学习“go语言免费学习笔记（深入）”；
- 最稳做法：从真实响应中拷贝 JSON，粘贴到测试里作为基准
- 用
map[string]interface{}先解一次，打印出来确认 key 名和类型 - 如果 API 有 OpenAPI 定义，用
go-swagger或oapi-codegen生成 struct，别手写 - 别在 Mock 里故意简化字段（比如删掉
"created_at"），除非你明确知道调用方不依赖它
测试 HTTP 客户端时，别直接改 http.DefaultClient
很多人为了“全局替换”，在测试前把 http.DefaultClient.Transport 换成 http.RoundTripper 实现，结果影响其他并行测试，或漏还原导致后续测试发请求失败。
正确姿势是让被测代码接受一个 *http.Client 参数，或通过接口抽象（比如 type HTTPDoer interface { Do(*http.Request) (*http.Response, error) }），测试时传入自定义 client。
-
http.Client本身是可组合的：新建 client 时传入&http.Client{Transport: mockTransport} - 如果你用的是封装过的请求函数（如
DoGet(url string) (User, error)），就给它加一个DoGetWithClient(url string, client *http.Client)变体 - 别依赖
init()或包级变量初始化 client，那会让测试无法控制依赖
需要多端点或动态响应？用 http.ServeMux 而不是硬编码 if 判断
当 Mock 需要支持 /users、/users/123、/healthz 多个路径，或者根据 query 参数返回不同数据时，堆 if r.URL.Path == "/xxx" 很快变难维护。
http.ServeMux 是标准库自带的轻量路由，无第三方依赖，且完全兼容 httptest.Server。
- 先 new 一个
http.ServeMux，用mux.HandleFunc("/users", usersHandler)注册 - 正则不熟？用
strings.HasPrefix(r.URL.Path, "/users/")提取 ID，比自己 parse path 安全 - 想按 method 区分？
if r.Method != "POST" { http.Error(w, "Method not allowed", http.StatusMethodNotAllowed); return } - 别忘了 404：在 mux 后加个兜底 handler，避免测试因路径拼错而卡住或返回 200 空内容
复杂点在于路径参数提取和状态流转（比如 POST 创建后，GET 要返回刚存的值），这些没法靠静态 JSON 解决，得在内存里维护简单 state，但千万别用全局 map —— 每个测试用独立 mux + 独立 map 才可靠。
