用 net/http/httptest 可高效测试 HTTP handler:通过 httptest.NewRecorder 捕获响应,构造 *http.Request,传入 handler 后检查状态码、响应体和头;需模拟路径/查询参数及 JSON 请求体;应验证业务逻辑而非仅 HTTP 层,依赖抽为接口并注入 mock;集成到 go test,保持测试独立性。

直接用 Go 标准库的 net/http/httptest 就能高效测试 HTTP handler,不用启动真实服务器,也不依赖外部工具。
用 httptest.NewRecorder 捕获响应
这是最核心的一步:创建一个假的响应写入器(ResponseWriter),让 handler 把结果写进去,而不是发给真实客户端。
- 调用
httptest.NewRecorder()得到一个可读写的*httptest.ResponseRecorder - 构造一个
*http.Request(可用http.NewRequest(),注意传入正确的 method、URL 和 body) - 把 recorder 和 request 一起传给你的 handler 函数(如
myHandler(recorder, req)) - 之后就能检查
recorder.Code(状态码)、recorder.Body.String()(响应体)、recorder.Header()(响应头)
测试带路径参数或查询参数的接口
Go 的 handler 通常不直接解析 URL 参数,而是靠路由库(如 gorilla/mux)或手动从 r.URL.Query() / r.URL.Path 提取。测试时要模拟真实请求结构。
- 查询参数:在
http.NewRequest("GET", "/api/users?id=123&name=john", nil)中拼进 URL - 路径参数:如果用
gorilla/mux,需用mux.SetURLVars(r, map[string]string{"id": "456"})注入变量 - JSON 请求体:用
bytes.NewReader([]byte(`{"name":"alice"}`))构造 body,并设 headerr.Header.Set("Content-Type", "application/json")
验证 handler 的业务逻辑而非仅 HTTP 层
别只测“返回了 200”,重点应是逻辑是否按预期执行——比如数据库是否被调用、错误是否被正确处理、返回数据结构是否合法。
立即学习“go语言免费学习笔记(深入)”;
- 把依赖(如数据库、缓存)抽成接口,测试时注入 mock 实现
- 对 handler 外部调用做断言:例如 mock DB 的
Insert()是否被调用一次,参数是否匹配 - 检查 JSON 响应体是否可解码为预期 struct,再断言字段值(比字符串匹配更可靠)
集成到标准测试流程中
Go 的 go test 原生支持,把测试函数写成 func TestXXX(t *testing.T) 即可运行。
- 每个测试用例保持独立,避免共享状态(如全局变量、未清理的 mock)
- 用
t.Run("case name", func(t *testing.T) { ... })组织子测试,便于定位失败项 - 加上
if !t.Failed() { t.Log("success") }这类辅助日志,调试时更直观(非必需)
基本上就这些。不需要额外框架,标准库足够轻量又可靠。关键在于把 handler 当普通函数来测,隔离外部依赖,专注输入输出和内部行为。










