直接测 handler 函数时用 httptest.NewRecorder；需完整 HTTP 生命周期（如重定向、中间件、TLS）才用 httptest.NewServer。前者轻量快速，适合 90% 单元测试；后者启真实服务，易致端口冲突、变慢，属集成测试范畴。
用 httptest.NewServer 还是 httptest.NewRecorder？
直接测 handler 函数时，用 httptest.NewRecorder；需要走完整 HTTP 生命周期（比如含重定向、中间件、TLS 逻辑）才用 httptest.NewServer。前者轻量、可控、速度快，90% 的接口单元测试都该选它。
常见错误是误用 NewServer 导致测试变慢、端口冲突、无法断言响应头细节。它本质是启一个真实 HTTP server，适合集成测试，不是单元测试的默认选项。
-
NewRecorder返回*httptest.ResponseRecorder，可直接读取Code、Body、Header() - 传入 handler 时注意类型：必须是
http.HandlerFunc，不是http.Handler实例（除非显式转成函数） - 若 handler 依赖全局变量（如数据库连接），测试前需临时替换，避免污染其他测试
如何模拟请求参数（query、form、JSON body）？
Go 标准库不自动解析 body，handler 里通常调用 r.ParseForm() 或 json.NewDecoder(r.Body).Decode()。测试时得手动构造符合预期格式的请求。
关键点在于设置 Content-Type 头和写入正确格式的 Body，否则 handler 解析会失败或静默跳过。
立即学习“go语言免费学习笔记（深入）”；
- GET query：用
url.Values{"key": {"value"}}.Encode()拼到 URL 后 - POST form：设
Content-Type: application/x-www-form-urlencoded，body 填编码后的值 - POST JSON：设
Content-Type: application/json，body 填合法 JSON 字符串（注意引号转义） - 忽略 body 解析错误？别这么做——应在测试中显式检查
err != nil分支
req, _ := http.NewRequest("POST", "/api/user", strings.NewReader(`{"name":"alice","age":30}`))
req.Header.Set("Content-Type", "application/json")
rr := httptest.NewRecorder()
handler.ServeHTTP(rr, req)
怎么测中间件或路由注册后的完整链路？
如果你用的是 gorilla/mux、chi 或自定义路由，不能只测单个 handler，得把 router 实例传进去。否则中间件（如日志、鉴权）不会执行，测试覆盖不全。
常见疏漏是测试“裸 handler”，结果上线后中间件 panic 或拦截逻辑失效，却没在单元测试里暴露出来。
- 测试前确保路由已注册：例如
r.HandleFunc("/api/user", userHandler).Methods("POST") - 用
http.NewRequest构造请求时，路径和 method 必须与路由规则完全匹配，否则返回 404 - 若中间件修改了
ResponseWriter（如加 header、压缩 body），需在rr.Result()或rr.Header()中验证 - 不要在测试里启动监听，
router.ServeHTTP(rr, req)就够了
如何安全地 mock 依赖（DB、外部 API）？
handler 里调用 db.QueryRow(...) 或 http.DefaultClient.Do(...) 会导致测试不稳定、慢、依赖网络。必须隔离这些调用。
最稳妥的方式是把依赖抽象为接口，在 handler 中接收接口实例（而非具体类型），测试时传入 mock 实现。硬编码调用全局 client/db 是测试噩梦的源头。
- 定义接口如
type UserStore interface { GetByID(id int) (*User, error) } - handler 改为接收该接口：
func NewUserHandler(store UserStore) http.HandlerFunc - 测试时实现 mock：返回预设数据或特定 error，验证 handler 是否正确处理各种 case
- 避免用
monkey.Patch等运行时打桩——破坏类型安全，且在 Go 1.21+ 中可能失效
type mockUserStore struct{}
func (m mockUserStore) GetByID(id int) (*User, error) {
if id == 1 {
return &User{Name: "alice"}, nil
}
return nil, errors.New("not found")
}
测试里最容易被忽略的，是 handler 对 context.Context 的使用（比如超时控制、trace 注入）以及对 http.Error 的调用路径——它们不会改变 ResponseRecorder 的 Code，但会影响上层行为，需要单独覆盖。 
