Go HTTP测试核心是用httptest.NewRequest和httptest.NewRecorder绕过网络、直接测试handler,结合mock依赖与框架适配,覆盖成功及错误路径。

在 Go 中测试 HTTP 请求处理逻辑,核心是绕过真实网络、避免启动完整 HTTP 服务器,直接用 http.HandlerFunc 或 http.Handler 配合 httptest.NewRequest 和 httptest.NewRecorder 构造可控的请求与响应环境。这样既快又稳定,还能精准覆盖各种分支路径。
用 httptest 模拟请求和响应
httptest.NewRequest 创建一个伪造但结构完整的 *http.Request,支持设置方法、URL、Header、Body;httptest.NewRecorder 则提供一个内存中的 http.ResponseWriter 实现,能捕获状态码、Header、响应体等全部输出。
- 构造 POST 请求并写入 JSON Body:
req := httptest.NewRequest("POST", "/api/user", strings.NewReader(`{"name":"Alice"}`)) - 设置 Header:
req.Header.Set("Content-Type", "application/json") - 调用 handler:
rr := httptest.NewRecorder()
handler.ServeHTTP(rr, req) - 断言结果:
if rr.Code != http.StatusOK { t.Fatal("expected 200") }
body := rr.Body.String()
测试路由与中间件(如 Gin/Chi)
若使用 Gin、Echo、Chi 等框架,不能直接传 handler,需借助框架提供的测试辅助方式。例如 Gin 可用 gin.CreateTestContext + engine.ServeHTTP;Chi 则推荐用 chi.NewMux().ServeHTTP 配合 httptest。
- Gin 示例:
r := gin.Default()
r.POST("/login", loginHandler)
w := httptest.NewRecorder()
req, _ := http.NewRequest("POST", "/login", strings.NewReader(`{"user":"a"}`))
r.ServeHTTP(w, req) - Chi 示例:
r := chi.NewRouter()
r.Post("/upload", uploadHandler)
w := httptest.NewRecorder()
req := httptest.NewRequest("POST", "/upload", nil)
r.ServeHTTP(w, req) - 中间件测试:把中间件包装到 handler 外层再测,比如
authMiddleware(nextHandler),然后传入 mock 的 next 来验证是否拦截或放行。
模拟依赖服务(DB、外部 API)
真实 handler 往往依赖数据库或第三方 HTTP 客户端。测试时应注入 mock 实现,而非连接真实服务。
立即学习“go语言免费学习笔记(深入)”;
- 定义接口抽象 DB 操作,如
type UserRepository interface { GetByID(id int) (*User, error) },测试时传入 struct 实现该接口并返回预设数据。 - 对外部 HTTP 调用,可替换
http.Client的Transport字段为httptest.Transport,或更常用的是用gock(第三方库)拦截并 stub 请求。 - 示例(用 gock):
gock.New("https://api.example.com").Get("/status").Reply(200).JSON(map[string]string{"ok": "true"})
defer gock.Off()
覆盖边界与错误场景
好测试不止看“成功路径”,更要验证参数缺失、格式错误、权限不足、DB 返回 error 等情况。
- 空 Body 或非法 JSON:
req := httptest.NewRequest("POST", "/api", strings.NewReader("{")) // JSON syntax error - 缺失必要 Header:
req.Header.Del("Authorization") // 测试鉴权中间件拒绝 - 模拟 DB error:
mockRepo.GetByIDFunc = func(id int) (*User, error) { return nil, errors.New("timeout") } - 检查错误响应结构是否符合预期(如 status 500 + JSON error message)。
基本上就这些。Golang 的 HTTP 测试不复杂但容易忽略细节——关键是把 handler 当纯函数测,隔离外部依赖,用 httptest 打好地基,再按需叠加框架适配和 mock 策略。










