绝大多数HTTP接口测试应优先用httptest.NewRequest+httptest.NewRecorder测单个handler，轻量快速、不占端口、不走网络；仅当验证中间件、路由链路或客户端行为时才需httptest.NewServer，并须defer srv.Close()防泄漏。
绝大多数 HTTP 接口测试根本不需要起服务——直接用 httptest.NewRequest + httptest.NewRecorder 调 handler 就够了。起 httptest.NewServer 只在测中间件、路由链路或你写的 HTTP 客户端时才必要，滥用它会导致端口冲突、goroutine 泄漏、CI 超时。
怎么测单个 handler 函数（比如 LoginHandler）
核心是绕过网络层，把 handler 当普通函数调：构造请求、传 recorder、检查输出。
-
http.NewRequest("POST", "/login", strings.NewReader(<code>`{"user":"a","pass":"123"}`))，必须显式设req.Header.Set("Content-Type", "application/json") -
rr := httptest.NewRecorder()后，调handler.ServeHTTP(rr, req)—— 漏掉这行等于没执行逻辑 - 状态码从
rr.Code读，不是rr.Result().StatusCode（后者在 panic 时会跟着 panic） - 响应体别用
rr.Body.String()直接字符串比对 JSON，容易因空格、字段顺序、新增字段失败；优先json.Unmarshal(rr.Body.Bytes(), &actual)到结构体再断言字段
怎么测带路径参数或查询参数的路由
标准库 http.ServeMux 不解析路径变量，第三方路由（如 gorilla/mux、chi）需要额外注入，否则 handler 拿不到 {id} 值。
- 查询参数：拼在 URL 里，如
http.NewRequest("GET", "/api/users?id=7&limit=10", nil)；或更安全地用url.Values{"id": {"7"}, "limit": {"10"}}.Encode() - 路径参数（
gorilla/mux）：先写死路径（如/api/user/123），再用mux.SetURLVars(req, map[string]string{"id": "123"})注入 - Gin/Echo 等框架需走其上下文机制，不能跳过；Gin 测试前要
gin.SetMode(gin.TestMode)，再用gin.CreateTestContext(rr) - 别忘了
req.ParseForm()或req.ParseMultipartForm()，否则req.Form始终为空
什么时候必须用 httptest.NewServer
只有两种情况绕不开它：一是中间件参与响应流程（JWT 鉴权、CORS、日志），NewRecorder 会完全跳过；二是你在测自己封装的 HTTP 客户端（比如带重试、超时、跳转逻辑）。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
-
srv := httptest.NewServer(yourMux)返回的是完整 URL（如"http://127.0.0.1:34212"），拼路径时写srv.URL + "/api"，不是"http://" + srv.URL + "/api" - 每次调用都绑定新端口，必须
defer srv.Close()，否则并发测试时会报bind: address already in use - 不支持 HTTPS；若需 TLS 测试，得用
httptest.NewUnstartedServer手动配srv.TLS - handler 依赖全局状态（如 DB 连接池、配置变量），测试前需重置或注入 mock，否则状态污染会导致后续测试失败
JSON 响应断言最容易踩的三个坑
80% 的测试失败不是逻辑错，是 JSON 处理漏了类型转换或错误检查。
- 用
map[string]interface{}解析时，JSON 数字是float64类型，resp["id"] == 123会失败，得写resp["id"] == float64(123) - handler 里用
json.NewDecoder(r.Body).Decode(&v)后，必须检查解码 error，否则 400 请求可能静默跳过业务逻辑 - 响应体校验时，定义最小结构体（如
type loginResp struct { Token string }），避免因 API 响应加字段导致测试崩
最常被忽略的一点：handler 没显式调用 w.WriteHeader 时，rr.Code 默认是 0，不是 200；别只断言状态码，要验证业务逻辑是否真被执行——比如数据库方法是否被调用、错误分支是否覆盖到。
