gin.CreateTestContext可直接创建测试用的gin.Context和httptest.ResponseRecorder，无需启动HTTP服务；需手动设置c.Request、路由参数及中间件，mock时须保持context.Context传递一致。
直接用 gin.CreateTestContext 模拟请求上下文
不需要启动 HTTP 服务，也不依赖 http.NewRequest 构造完整请求对象。Gin 提供了轻量级的测试上下文构造方式，核心是复用已有 handler 签名，只替换 *gin.Context 的底层实现。
关键点在于：你写的 handler 函数签名是 func(*gin.Context)，而测试时只需给它一个「假但合法」的 *gin.Context 实例 —— gin.CreateTestContext 正是干这个的。
- 它返回
*gin.Context和配套的*httptest.ResponseRecorder，后者能捕获响应状态码、Header、Body - 必须在调用前设置好路由参数（如
c.Params = gin.Params{{Key: "id", Value: "123"}}），否则c.Param("id")返回空字符串 - 如果 handler 里用了
c.BindJSON或c.BindQuery，得提前把模拟请求体或查询字符串写进recorder对应字段，或者更稳妥地：用httptest.NewRequest+gin.CreateTestContext组合
用 httptest.NewRequest + gin.CreateTestContext 模拟真实请求流
这是最贴近运行时行为的写法，尤其适合带 JSON body、query、form、header 的接口。它不走网络，但完整复现了 Gin 内部从 request 解析到 context 绑定的链路。
示例：测试一个 POST /users 接口
func TestAddUser(t *testing.T) {
r := gin.New()
r.POST("/users", AddUser) // 假设这是你的 handler
req, _ := http.NewRequest("POST", "/users", strings.NewReader(`{"username":"alice"}`))
req.Header.Set("Content-Type", "application/json")
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
c.Request = req
r.HandleContext(c)
if w.Code != http.StatusOK {
t.Fatalf("expected 200, got %d", w.Code)
}
}
- 别漏掉
c.Request = req，这是最关键的一步，否则c里没有原始请求数据 - 如果 handler 依赖中间件（比如 auth 中间件检查 header），测试前要显式
r.Use(AuthMiddleware)，否则中间件逻辑不会触发 - 避免在测试中调用
r.Run()或监听端口，那会阻塞并启动真实服务
Mock 服务层依赖时，注意 context.Context 传递一致性
Controller 层通常只负责 HTTP 协议适配，业务逻辑下沉到 service 层。单元测试 Controller 时，service 应该被 mock 替换。但容易忽略的是：mock 方法签名里的 context.Context 必须和 controller 调用时传入的一致，否则超时、取消、value 注入等行为无法对齐。
- mock 方法不能硬编码
context.Background()，得接收并透传 controller 传来的ctx - 如果你在 handler 里用了
ctx.WithTimeout或ctx.WithValue，mock 实现也得支持对应行为，否则测试通过但线上出错 - 用
gomock或mockgen生成 mock 时，确保 interface 方法签名含context.Context参数，且类型完全匹配（比如别混用context.Context和自定义 ctx 类型）
别跳过中间件的测试覆盖
很多 Gin 项目把鉴权、日志、限流等逻辑放在中间件里。如果只测 handler，等于绕过了这些关键路径。中间件本身是 gin.HandlerFunc 类型，可单独测试。
- 写个独立函数，用
gin.CreateTestContext构造c，手动调用中间件函数，再检查c.Abort()是否被调用、w.Code是否为 401 等 - 如果中间件依赖外部配置（如 JWT 密钥），测试时用固定值初始化，不要读真实 config 文件
- 对 panic 恢复类中间件（如 Gin 默认的
Recovery()），可主动在 handler 里panic("test")，验证是否返回 500 而非崩溃
ctx.Done() 检查，上线后都可能变成偶发超时。 
