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

# js # json # go # golang # 编码 # app # 端口 # 路由 # 标准库 # 中间件 # Error # 全局变量 # 字符串 # int # 接口 # Interface # nil # 数据库 # http # router # 单元测试 # 变慢 # 才用 # 的是 # 重定向 # 自定义 # 应在 # 这么做 # 速度快 # 而非

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】