httptest.NewServer 适合集成测试，不是单元测试
单元测试里不该启动真实 HTTP 服务器，哪怕只监听 localhost。它会占用端口、引入网络延迟、依赖外部状态，还可能和并行测试冲突。httptest.NewServer 是为端到端或集成测试准备的，比如验证整个 handler 链路是否能正确响应 curl 请求。
真正做单元测试时，应该直接调用 handler 函数，把 *http.Request 和 http.ResponseWriter 的模拟实例传进去——而 httptest.NewRecorder 就是为此生的。
- 用
httptest.NewRecorder()替代真实响应体，它实现了http.ResponseWriter接口，但把输出存在内存里 - 用
http.NewRequest()构造请求，注意 method、URL、body 都得手动设好，尤其是 POST/PUT 的Content-Type - 别忘了在 handler 调用前设置好路由参数（如果用了
gorilla/mux或chi），它们不会自动注入到req.Context()
handler 测试必须显式调用 ServeHTTP
Go 的 HTTP handler 类型本质是函数： func(http.ResponseWriter, *http.Request)。很多人误以为注册到 http.ServeMux 后就能“自动执行”，但在测试里你得亲手触发它。
常见错误是写了 handler 却没调用，或者调用时传了 nil 的 ResponseWriter，结果 panic 报 nil pointer dereference。
立即学习“go语言免费学习笔记（深入）”；
- 务必写成
myHandler.ServeHTTP(recorder, req)或myHandler(recorder, req)（取决于 handler 是 Struct 还是函数） - 如果 handler 是
http.HandlerFunc类型，可以直接调用；如果是自定义 struct，要确认它实现了ServeHTTP方法 - 测试中不要用
http.ListenAndServe或server := &http.Server{...}; server.Serve(...)，这已经脱离单元测试范畴
检查响应要分三步：状态码、头、正文
httptest.ResponseRecorder 把响应拆成三个可查字段：Code、Header()、Body。漏查任何一项都可能掩盖 bug，比如状态码对了但 Content-Type 错了，或 json 返回了 HTML 错误页。
尤其注意 Header() 返回的是 http.Header，不是 map，不能直接用 == 比较；Body.Bytes() 是原始字节，JSON 响应建议用 json.Unmarshal 解析后再断言结构。
- 状态码：直接比
recorder.Code == http.StatusOK - Header：用
recorder.Header().Get("Content-Type") == "application/json" - 正文：优先用
recorder.Body.String()看原始内容，调试时最直观；正式断言建议解析后比字段，避免空格/换行干扰
中间件测试容易忽略上下文传递
带中间件的 handler（比如 auth、Logging）往往依赖 req.Context() 注入值。单元测试里这个 context 默认是 context.background()，什么都没有——所以中间件可能跳过逻辑，或者 handler 因取不到 ctx.Value("user") 而 panic。
这不是 httptest 的问题，而是测试构造不完整。你得手动把需要的值塞进 context，再挂到 request 上。
- 用
context.WithValue(req.Context(), key, value)创建新 context - 用
req.WithContext(newCtx)生成带上下文的新请求 - key 最好定义为私有类型（如
type userKey string），避免字符串 key 冲突 - 如果中间件修改了 response header，记得在中间件调用后检查
recorder.Header()，而不是只看最终 body
测试最难的从来不是怎么 mock，而是搞清 handler 真正依赖什么——是 URL 路径？Query 参数？Header 字段？Context 值？还是某个全局变量？漏掉任意一个，测试就只是“看起来过了”。