Gin单元测试应使用gin.CreateTestContext配合httptest.NewRequest构造mock请求，避免启动真实服务器；需显式注册中间件、用ShouldBindJSON替代BindJSON、手动设置Query/Header/Cookie/Form等参数。
直接用 gin.CreateTestContext 搭配 httptest.NewRequest 发起请求
Gin 本身不依赖 HTTP 服务器启动就能跑测试，关键在于构造一个带 mock request/response 的上下文。别写 router.Run() 或起真实端口——那不是单元测试，是集成测试，慢且不稳定。
实操要点：
- 用
gin.New()或gin.Default()创建 router 实例，它本身是线程安全的，可复用 - 调用
httptest.NewRequest("GET", "/api/user/123", nil)构造请求，注意方法、路径、body（如需 JSON，用strings.NewReader(`{"name":"a"}`)） - 用
httptest.NewRecorder()创建响应记录器，它实现了http.ResponseWriter - 手动调用
router.ServeHTTP(w, req)，跳过监听端口环节
示例片段：
req, _ := http.NewRequest("GET", "/user/1", nil)
w := httptest.NewRecorder()
router.ServeHTTP(w, req)
if w.Code != http.StatusOK {
t.Fatalf("expected status %d, got %d", http.StatusOK, w.Code)
}
测试带中间件的路由时，必须显式注册中间件
Gin 的中间件不会自动生效于测试上下文——router.Use() 是声明式的，但测试中你得确保它被调用。漏掉中间件（比如 JWT 验证、日志、CORS）会导致测试通过但线上报错，或者反过来：测试失败但线上正常。
立即学习“go语言免费学习笔记（深入）”；
常见踩坑点：
- 只在 main.go 里调用了
r.Use(authMiddleware)，但测试文件里 new 出来的 router 是干净的，没加载任何中间件 - 中间件依赖外部服务（如 Redis、DB），测试时没 mock，导致 panic 或超时
- 使用
gin.TestMode不影响中间件行为，它只关闭了调试日志和一些 panic 捕获
建议做法：把 router 初始化逻辑抽成函数，接受中间件切片，测试时传入 mock 版本：
func NewRouter(mws ...gin.HandlerFunc) *gin.Engine {
r := gin.New()
r.Use(mws...)
r.GET("/user/:id", getUserHandler)
return r
}
// 测试时：
r := NewRouter(mockAuthMiddleware, mockLogger)
解析 JSON 请求体时，记得调用 c.ShouldBindJSON() 而非 c.BindJSON()
这是 Gin 测试中最隐蔽的错误来源之一。如果你 handler 里写的是 c.BindJSON(&u)，而请求 body 不合法（比如字段类型错、缺少必需字段），它会直接写 400 并终止执行——但你在测试里可能没检查 w.Code 就去读响应 body，结果拿到空字符串还误以为成功。
c.ShouldBindJSON() 不会自动响应，而是返回 error，让你自己决定怎么处理（比如统一错误格式、打日志）。这对测试友好得多：
- 你能断言绑定是否成功：
if err := c.ShouldBindJSON(&u); err != nil { ... } - 避免因绑定失败导致 handler 提前退出，便于验证后续逻辑分支
- 配合
assert.Error(t, err)可清晰覆盖 bad request 场景
表单、Query、Header、Cookie 等参数测试要手动设置
Gin 不从环境或全局状态读取这些值，全靠 *http.Request 携带。测试时如果忽略设置，c.Query("page") 返回空、c.GetHeader("Authorization") 是空字符串、c.Cookie("session_id") 报 http.ErrNoCookie——都不是 bug，只是你忘了塞。
对应设置方式：
- Query 参数：把它们拼进 URL，如
"/search?q=go&page=2"；或用req.URL.RawQuery = "q=go&page=2" - Header：用
req.Header.Set("Authorization", "Bearer abc") - Cookie：用
req.AddCookie(&http.Cookie{Name: "session_id", Value: "xyz"}) - Form 表单：设
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")，body 用url.Values{"name": []string{"foo"}}.Encode()
别依赖 router.POST("/form").Binding(&form) 自动识别——binding 只处理 body，query/header/cookie 全靠你手工喂给 request 对象。
真正难的不是写几个 t.Run，而是让每个测试都精准控制输入边界：少一个 header、错一个 content-type、空 body 却走 JSON 绑定路径……这些组合爆炸才是 Gin 接口测试容易漏掉的部分。
