httptest.NewRecorder是Go接口测试默认起点,适合验证输入校验、状态码、JSON响应等核心逻辑;集成测试需用testcontainers-go启动可控真实依赖;推荐表格驱动分层断言,并注意CI中资源清理与超时控制。

有用,而且效果直接可测——只要测试覆盖了真实调用路径、参数边界和错误分支,就能在 go test 运行时立刻暴露逻辑错、panic、空指针、JSON 字段遗漏等问题。它不保证业务正确,但能守住“代码不崩、接口不挂、字段不丢”这三条底线。
Handler 测试必须走 httptest.NewRecorder() 而不是发真实 HTTP 请求
真实请求要起服务、占端口、受网络干扰,慢且不稳定;而 httptest.NewRecorder() 直接把 Gin 的 router.ServeHTTP() 接入内存响应体,零延迟、可断言、可复现。
- 错误写法:用
http.Get("http://localhost:8080/xxx")—— 依赖端口空闲、服务已启动、防火墙放行 - 正确写法:构造
*http.Request+*httptest.ResponseRecorder,调router.ServeHTTP(w, req) - 注意:
gin.SetMode(gin.TestMode)要在TestMain或init中提前设,否则日志和 panic 行为不一致
c.Param()、c.Query()、c.BindJSON() 各自的测试要点
这三个是 Gin Handler 最常出错的输入点,测试时不能只喂“理想值”。
-
c.Param("id"):URL 路径中缺失该段(如/users/)会导致空字符串,需验证是否做了非空检查 -
c.Query("page"):传?page=会返回空字符串而非默认值,别假设它自动 fallback -
c.BindJSON(&v):若结构体字段没加json:tag,或用了omitempty却传了零值,响应里字段就消失——测试得用assert.JSONEq()校验完整输出
Mock 数据库或外部服务时,别 mock 整个 struct,只 mock 方法签名
用 testify/mock 或 gomock 生成 mock 时,重点不是“看起来像 DB”,而是“能控制返回值+验证调用次数”。
- 错误做法:mock
*sql.DB全部方法——工作量大、易过时、掩盖真实依赖 - 正确做法:定义 interface,比如
type UserRepo interface { GetUser(id string) (User, error) },只 mock 这一个方法 - 关键细节:mock 调用后必须显式调
mock.AssertExpectations(t),否则即使没调用也不会报错
最常被跳过的其实是中间件测试——比如 JWT 验证中间件,不测它,Handler 就永远收不到合法 c.MustGet("user_id")。这类测试需要手动 c.Set() 模拟上下文,否则一跑就 panic。


















