Golang中的API请求结果Mock服务搭建 Go语言快速原型开发技巧

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 才可靠。