如何使用Golang测试HTTP接口_Golang net/http测试实践_网络技术

如何使用Golang测试HTTP接口_Golang net/http测试实践

发布时间 - 2026-01-25 00:00:00 点击率：次

httptest 包提供两种核心测试方式：NewServer 用于集成测试完整 HTTP 流程（启动真实本地服务器），NewRequest+NewRecorder 用于单元测试单个 handler（内存中无网络调用）。

Go 的 net/http/httptest 包不是“模拟 HTTP 客户端”，而是专门用来**测试 HTTP 服务端逻辑**的——它帮你启动一个内存中的假服务器，绕过网络层，直接把请求打进去，再检查响应。如果你在测自己写的 http.HandlerFunc 或 http.ServeMux，这才是正路。

用 httptest.NewServer 测试完整 HTTP 服务流程

适用于已封装好 http.Handler（比如 Gin、Echo 或自定义 mux），需要走一遍真实 TCP 连接、HTTP 解析、中间件链路的场景。它会起一个监听随机端口的真实本地服务器，适合集成测试。

每次调用 httptest.NewServer 都会绑定新端口，记得调用 srv.Close() 释放资源，否则可能端口耗尽
返回的 srv.URL 是带协议和端口的完整地址（如 "http://127.0.0.1:34212"），客户端代码必须用它，不能硬写 "localhost:8080"
不支持 HTTPS，默认只跑 HTTP；若需 TLS 测试，得用 httptest.NewUnstartedServer + 手动配置 srv.TLS

func TestFullFlow(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		if r.URL.Path == "/api/v1/users" && r.Method == "GET" {
			w.WriteHeader(200)
			json.NewEncoder(w).Encode([]map[string]string{{"id": "1", "name": "alice"}})
		}
	}))
	defer srv.Close() // 必须

	resp, err := http.Get(srv.URL + "/api/v1/users")
	if err != nil {
		t.Fatal(err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != 200 {
		t.Errorf("expected 200, got %d", resp.StatusCode)
	}
}

用 httptest.NewRequest + httptest.NewRecorder 测试单个 handler 函数

这是最轻量、最常用的方式，适合单元测试单个 http.HandlerFunc。不走网络、不占端口、无并发干扰，执行快且可断言内部状态（比如是否调用了某个依赖函数）。

httptest.NewRequest 构造请求时，body 参数为 nil 表示空体；若要传 JSON，得用 strings.NewReader(`{"name":"bob"}`) 并设 Content-Type: application/json
httptest.NewRecorder 返回的 *httptest.ResponseRecorder 不是 http.ResponseWriter 接口实现体，但兼容；它的 Body.Bytes()、Code、Header() 都可直接读取
注意：handler 内部若调用 http.Redirect，recorder.Code 会是 302，recorder.Header().Get("Location") 可取跳转地址

func TestUserCreateHandler(t *testing.T) {
	req := httptest.NewRequest("POST", "/users", strings.NewReader(`{"name":"bob"}`))
	req.Header.Set("Content-Type", "application/json")

	rr := httptest.NewRecorder()
	handler := http.HandlerFunc(userCreateHandler)
	handler.ServeHTTP(rr, req)

	if status := rr.Code; status != http.StatusCreated {
		t.Errorf("handler returned wrong status code: got %v want %v",
			status, http.StatusCreated)
	}

	var result map[string]string
	if err := json.Unmarshal(rr.Body.Bytes(), &result); err != nil {
		t.Fatal(err)
	}
	if result["name"] != "bob" {
		t.Error("expected name 'bob'")
	}
}

测试带中间件或依赖注入的 handler 链

真实项目中 handler 往往嵌套中间件（如日志、鉴权）或接收外部依赖（DB、cache）。这时不能只测裸 handler，得把整条链“组装”起来再测。

中间件本质是 func(http.Handler) http.Handler，测试时用 middleware(next) 包一层再传给 ServeHTTP 即可
若 handler 依赖结构体字段（如 type UserHandler struct { DB *sql.DB }），先构造实例，再用其方法作为 handler： h := &UserHandler{DB: mockDB}; h.ServeHTTP(rr, req)
避免在测试里 new 出真实 DB 或 Redis 客户端；用 interface + mock（如 mockDB := &MockQuerier{...}）控制返回值

func TestAuthMiddleware(t *testing.T) {
	mockDB := &MockUserDB{}
	handler := AuthMiddleware(UserCreateHandler(mockDB))

	req := httptest.NewRequest("POST", "/users", nil)
	rr := httptest.NewRecorder()

	// 无 token → 应该 401
	handler.ServeHTTP(rr, req)
	if rr.Code != http.StatusUnauthorized {
		t.Error("expected 401 without Authorization header")
	}

	// 带有效 token → 应该 201
	req.Header.Set("Authorization", "Bearer valid-token")
	rr = httptest.NewRecorder()
	handler.ServeHTTP(rr, req)
	if rr.Code != http.StatusCreated {
		t.Error("expected 201 with valid token")
	}
}

真正难的不是怎么写测试，而是怎么让 handler 足够“可测”：别在函数里直接调 log.Println 或 os.Exit，别把数据库连接写死在 handler 里，别用全局变量存配置。越早把依赖抽象成参数或接口，后续加测试就越省力。

# redis # js # json # go # golang # app # 端口 # golang测试 # red # sql # 中间件 # gin # echo # 封装 # 全局变量 # 结构体 # 接口 # Struct # Interface # nil # 并发 # location # 数据库 # http # https # 客户端 # 这是 # 单元测试 # 你在 # 两种 # 帮你 # 适用于 # 一遍 # 自定义 # 不支持

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

上一篇：搜狗浏览器网页版访问链接无需安装直接打开的官方入口

下一篇：vscode如何重置设置 vscode恢复默认配置的简易指南

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：搜狗浏览器网页版访问链接无需安装直接打开的官方入口

下一篇：vscode如何重置设置 vscode恢复默认配置的简易指南