httptest.server 是 go 中 mock 外部 api 的标准方式，通过启动本地 http 服务并注入 srv.url 替换硬编码地址实现；需避免硬编码 url、忽略 body 处理、复用 client 连接池等问题。
用 httptest.Server 替换真实 HTTP 客户端地址
Mock 外部 API 的本质，是让代码里发出去的请求不真走网络，而是打到一个本地可控的测试服务上。Go 标准库的 httptest.Server 就是干这个的——它启动一个临时 HTTP 服务，返回你指定的响应，且自动管理端口和生命周期。
关键不是“怎么伪造响应”，而是“怎么让被测代码用上这个伪造服务”。常见错误是只写了 httptest.NewServer，却没把返回的 URL 注入到实际调用的客户端里。
- 被测代码中，HTTP 客户端（比如
http.Client）发起请求时，目标地址必须可配置；硬编码"https://api.example.com"就没法 Mock - 推荐做法：把基础 URL 抽成字段或参数，测试时传入
srv.URL（例如srv := httptest.NewServer(...); defer srv.Close()） - 注意
srv.URL是http://开头，即使你模拟的是 HTTPS 接口——httptest.Server不支持 TLS，测试中也不需要
http.Client 的 Transport 可以拦截请求但没必要
有人会想用自定义 http.Transport + RoundTrip 拦截请求并返回 mock 响应，技术上可行，但属于过度设计。除非你在测 Transport 层行为本身（比如重试逻辑、代理设置），否则绕过网络层直接换 endpoint 更简单、更贴近真实调用链。
- 自定义
Transport容易漏掉对Request.Body的读取或关闭，导致测试 panic 或 goroutine 泄漏 - 如果被测代码用了第三方 HTTP 客户端（如
resty、go-resty），它们通常也支持设置 base URL，优先走 URL 替换路径 -
httptest.Server自动处理并发请求、连接复用、超时等细节，比手写RoundTrip稳定得多
JSON 响应体要匹配结构体字段的导出规则
用 json.Marshal 返回 mock 数据时，如果被测代码反序列化进 struct，字段名大小写不匹配会导致解析失败——这不是 HTTP 问题，而是 Go 的 JSON 标签陷阱。
- struct 字段首字母小写（如
id int）不会被 JSON 包含，必须大写（ID int）或显式加json:"id" - mock 响应里多写了字段（比如服务端实际返回
{"name":"a"}，你 mock 成{"name":"a","age":10}），只要被测 struct 没定义Age字段，就完全没问题；少字段也不会报错，只是对应字段为零值 - 建议在测试里用
t.Log(string(body))打印实际返回内容，避免靠猜调试
别忘了清理 httptest.Server 和 http.Client 连接
httptest.Server 虽然有 Close()，但如果你在测试中复用同一个 http.Client，它的连接池可能还缓存着旧 server 的连接，下次请求会卡住或报 connection refused。
- 每个测试用例都该有自己的
httptest.Server实例，并在defer srv.Close()——不能只在测试函数末尾 close，得确保它在 test scope 内结束 - 如果被测代码用了全局
http.DefaultClient，测试前最好设http.DefaultClient = &http.Client{...}，避免污染其他测试 - 极端情况（比如并发测试多个 server），端口冲突会报
listen tcp :0: bind: address already in use，这时加httptest.NewUnstartedServer手动选端口反而更稳
最常被跳过的其实是「让被测代码知道该连谁」这一步。写完 srv := httptest.NewServer 后，如果没把 srv.URL 传进去，那所有后续逻辑都在跟真实网络较劲，mock 就等于没做。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
