正确构造测试请求需确保URL带协议和路径、body显式设为nil或io.Reader，并设置Content-Type；用httptest.NewRecorder捕获响应；完整链路测试应通过httptest.NewServer启动服务而非直调handler。
怎么用 httptest.NewRequest 构造测试请求
构造请求是 httptest 最基础也最容易出错的一步。很多人直接传空字符串或忽略 method 和 url 格式，导致后续 handler 解析失败。
关键点：URL 必须带协议和路径（哪怕只是测试用），body 需要显式设置为 nil 或 io.Reader，不能传字符串字面量。
-
httptest.NewRequest("GET", "http://example.com/api/users", nil)—— 正确，协议 + 路径 + 空 body -
httptest.NewRequest("POST", "/api/users", strings.NewReader(`{"name":"a"}`))—— POST 带 JSON body，注意设好Content-Type - 漏掉
req.Header.Set("Content-Type", "application/json")→ handler 可能跳过 JSON 解析 - 用
"localhost:8080/path"当 URL →req.URL解析失败，req.Host为空，影响路由匹配
如何让 handler 正确处理测试请求
构造完 *http.Request 后，直接丢给 handler 是不够的。handler 通常依赖 http.ResponseWriter 的具体行为（比如写状态码、header、body），而真实响应器在测试中不可用。
httptest.NewRecorder() 就是为此设计的：它实现了 http.ResponseWriter 接口，把所有写入缓存在内存里，方便断言。
立即学习“go语言免费学习笔记（深入）”；
- 调用顺序必须是：
req := httptest.NewRequest(...); w := httptest.NewRecorder(); handler.ServeHTTP(w, req) - 别用
http.Response或自定义 struct 替代*httptest.ResponseRecorder，否则拿不到w.Code、w.Body.String() - 如果 handler 内部调用了
http.Redirect，检查w.Header().Get("Location")和w.Code == http.StatusFound - 注意
w.Body.Bytes()和w.Body.String()的区别：后者会尝试 UTF-8 解码，遇到非法字节可能 panic
为什么测试时路由不生效？
直接调用某个 handler 函数（如 usersHandler(w, req)）绕过了路由层，自然不会触发 http.ServeMux 或 gorilla/mux 的路径匹配、中间件等逻辑。
要测完整链路，得把 handler 放进实际的 server 实例里跑，而不是单测函数。
- 用
http.NewServeMux()注册路由后，传给httptest.NewServer(mux)→ 返回一个带真实地址的*httptest.Server - 然后用
http.Get(server.URL + "/api/users")发请求，走完整 HTTP 栈（含 net/http transport） - 更轻量的做法：用
server := httptest.NewServer(http.HandlerFunc(yourHandler))，适合只测单个 endpoint - 若用
gin、echo等框架，优先用它们自带的 test helper（如gin.CreateTestContext），而非硬套httptest
常见错误：Body 读取后无法重放
HTTP 请求体（req.Body）是单次读取的 io.ReadCloser。测试中如果 handler 多次调用 io.ReadAll(req.Body) 或先解析 JSON 再读原始 body，第二次就读不到内容了。
这不是 httptest 的 bug，而是 Go HTTP 的设计使然。测试时必须模拟可重放的 body。
- 构造请求时用
bytes.NewBufferString(jsonStr)替代strings.NewReader，前者支持Seek(0, 0) - 或者在 handler 开头加一句：
bodyBytes, _ := io.ReadAll(r.Body); r.Body = io.NopCloser(bytes.NewBuffer(bodyBytes)) - 更稳妥的方式：测试前就用
ioutil.NopCloser包一层可重放的 reader（Go 1.16+ 用io.NopCloser） - 忘记
req.Body.Close()不会导致 panic，但属于资源泄漏习惯，测试里也建议补上
真正麻烦的不是怎么写测试，而是当 handler 依赖外部服务（DB、Redis、第三方 API）时，httptest 本身不解决依赖隔离——那得靠 interface 抽象 + mock，或者用 net/http/httptest 搭配 gock 拦截 outbound 请求。这部分容易被忽略，但一旦漏掉，测试就从单元测试滑向了集成测试。