测试前必须设为gin.TestMode,否则会导致日志刷屏、中间件异常(如Recovery不输出堆栈)、绑定逻辑不一致;应于TestMain中统一设置,配合httptest.NewRequest和httptest.NewRecorder调用router.ServeHTTP完成内存级单元测试。

测试前必须设为 gin.TestMode
不设置会导致日志刷屏、中间件行为异常(比如 Recovery 中断 panic 后不输出堆栈)、甚至某些绑定逻辑表现不一致。Go 测试启动时最稳妥的方式是在 TestMain 中统一设置:
func TestMain(m *testing.M) {
gin.SetMode(gin.TestMode)
os.Exit(m.Run())
}
注意:gin.TestMode 不影响路由注册或 handler 执行逻辑,只抑制调试日志和修改部分内部 panic 处理策略;漏设后常见现象是测试卡住、c.Bind 返回奇怪错误、或 assert.JSONEq 断言失败但响应体实际正确。
httptest.NewRecorder() 和 router.ServeHTTP() 是核心组合
这是绕过真实 HTTP 服务、直接驱动 Gin 路由引擎执行 handler 的关键路径。别用 http.Get 或 curl——那属于集成测试,慢且不可控。
- 创建请求必须带完整 URL 和 method,例如
http.NewRequest("POST", "/login", bytes.NewReader(payload)) -
w := httptest.NewRecorder()是模拟的响应写入器,所有c.JSON/c.String都写进它 -
router.ServeHTTP(w, req)才真正触发路由匹配 + handler 执行,不调用这行等于没测 - 之后从
w.Code读状态码,w.Body.String()读响应体
参数绑定类 handler 测试要小心数据来源
Gin 的 c.ShouldBindJSON、c.Bind、c.Param、c.Query 等行为高度依赖请求构造方式,错配就会静默失败。
- JSON body → 请求体必须是
bytes.NewReader(jsonBytes),且 header 加req.Header.Set("Content-Type", "application/json") - form-data → 用
url.Values{"username": {"foo"}, "password": {"bar"}}.Encode()构造 body,header 设为"application/x-www-form-urlencoded" - URL 参数(如
/users/:id)→ 请求 URL 必须含占位值,如"/users/123",否则c.Param("id")返回空字符串 - Query 参数 → 拼在 URL 后,如
"/search?name=alice&page=2",不能塞 body 里
别在测试里启动真实服务器或依赖外部服务
单元测试目标是隔离验证单个 handler 行为。一旦引入 router.Run()、数据库连接、Redis 客户端或 HTTP 外部调用,就不再是单元测试,而是集成测试——速度慢、不稳定、难 debug。
真实依赖应通过接口抽象 + mock 替换,例如:
- 定义
type UserService interface { GetUser(id string) (User, error) } - handler 接收该接口作为参数,而非直接 new 一个实现
- 测试时传入 mock 实现(可用
github.com/stretchr/testify/mock或手动 struct 实现)
这个边界意识比怎么写断言更重要:测 handler 本身,不是测它连得上 MySQL。











