用 httptest.NewServer 测试 Handler 应起真实服务并调用 server.Close()，避免端口冲突；Handler 内部依赖的第三方请求需 mock，取地址用 server.URL 而非硬编码；httptest.NewRecorder 仅适合单元级响应验证，不覆盖中间件、TLS、重定向等真实链路。
怎么用 httptest.NewServer 测试依赖外部 HTTP 服务的 Handler
直接起一个真实 HTTP 服务来测 Handler，最接近线上行为，但容易被忽略的是：它默认不处理并发请求，且服务生命周期要手动管理。
常见错误现象：panic: listen tcp :0: bind: address already in use —— 多次调用 NewServer 没关旧服务；或者测试里用 http.Get 去访问 http://localhost:8080，但 Handler 其实依赖另一个远程地址，没 mock 掉。
- 每次测试后必须显式调用
server.Close()，推荐用defer server.Close() - 若 Handler 内部调用
http.Client请求第三方 API，别让它真发出去 —— 改用httptest.NewUnstartedServer+server.Start()控制启动时机，或更稳妥地替换http.DefaultClient的Transport字段为httptest.NewUnstartedServer返回的 handler -
NewServer分配的是随机空闲端口，别硬编码:8080；取地址用server.URL（含协议和端口）
为什么 httptest.NewRecorder 不能替代真实请求链路
它只捕获响应，不触发中间件、不走 net/http 的连接建立/超时/重定向逻辑，更不会执行 TLS 握手或 Host 头校验 —— 所以测路由分发、CORS、gzip 响应头、或依赖 r.Host/r.RemoteAddr 的逻辑时，会漏掉关键路径。
使用场景：单元级验证 Handler 内部逻辑是否写对了 w.WriteHeader 和 w.Write，比如 JSON 序列化是否出错、状态码是否符合预期。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 检查响应体必须用
recorder.Body.Bytes()，不是recorder.Body.String()—— 后者可能因编码问题丢字节 - 如果 Handler 修改了
w.Header().Set("Content-Type", ...)，得在WriteHeader之后读，否则recorder.Header()是空的 - 它不记录日志、不触发
http.Server.ErrorLog，所以 Handler 里log.Printf或 panic 不会出现在测试输出里，得靠 recover 或重定向stderr
Handler 测试中 http.Request 构造最容易错的三件事
很多测试失败不是逻辑问题，而是 http.NewRequest 调用方式不对，尤其涉及 body、header、URL 查询参数时。
- POST/PUT 请求带 JSON body，必须设
Content-Type: application/json，且body参数传strings.NewReader(jsonStr)，不是bytes.NewBufferString—— 后者在多次读时可能返回空 - URL 查询参数要用
url.Values{"key": []string{"val"}}.Encode()拼到 URL 后，别手动拼?key=val，否则空格、中文会乱码 - 测试路由变量（如
/:id）时，req.URL.Path必须和路由注册时完全一致（包括结尾斜杠），否则chi或gorilla/mux可能匹配失败
如何测带中间件的 Handler 链（比如 auth、logging）
中间件本质是函数套函数，测试的关键是把原始 Handler 包进中间件后再喂给 httptest，而不是单独测中间件本身。
性能影响：每层中间件都会增加一次函数调用和内存分配，但测试中可忽略；兼容性上注意中间件是否依赖 http.ResponseWriter 的具体实现（比如某些 gzip 中间件要求 wrapper 实现 http.Hijacker）。
- 用
middleware(handler)得到新http.Handler，再传给httptest.NewRecorder或NewServer - 如果中间件修改了
ResponseWriter（比如加 header），记得在测试里检查rec.Header().Get("X-Trace-ID")这类字段 - 别在测试里重复实现中间件逻辑（比如自己 parse token），那等于绕过被测代码 —— 真实 token 用
jwt-go生成，然后塞进req.Header.Set("Authorization", "Bearer xxx")
真正难的不是起服务或造请求，是判断哪一层该 mock、哪一层必须走真实网络。比如测限流中间件就得连 redis，但测它怎么解析 header 就不该碰网络。
