GolangHTTP接口测试技巧与方法

一分耕耘，一分收获！既然打开了这篇文章《Golang HTTP接口单元测试方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

直接测 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 解析会失败或静默跳过。

• 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，但会影响上层行为，需要单独覆盖。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GolangHTTP接口测试技巧与方法》文章吧，也可关注golang学习网公众号了解相关技术文章。