Gin单元测试需明确测试对象并规范实操：Handler必须用httptest.NewRecorder+router.ServeHTTP触发完整路由链，TestMain中全局设gin.TestMode，URL和查询参数需严格匹配路由，推荐assert.JSONEq断言JSON响应，并务必覆盖边界与清理逻辑。
gin 的单元测试不是“配好环境就能跑通”，而是得先理清测试对象——是纯函数、Handler、中间件，还是依赖外部服务的逻辑。直接套用 go test 往往卡在请求没发出去、上下文为空、日志干扰、或断言失败却看不出哪行没覆盖。下面直奔实操要点。
Handler 测试必须用 httptest.NewRecorder() + router.ServeHTTP()
不能直接调用 pingHandler(c *gin.Context)，因为 c 是空指针；也不能用真实 HTTP 客户端（如 http.Get），那样测的是整个服务生命周期，不是单元级。
-
httptest.NewRecorder()模拟响应写入，不走网络，可读取w.Code和w.Body.String() - 必须通过
router.ServeHTTP(w, req)触发完整 Gin 路由链，否则中间件、参数绑定、JSON 解析等都不会执行 - 别漏掉
gin.SetMode(gin.TestMode)，否则[GIN-debug]日志会刷屏，且部分调试行为（如 panic 捕获）表现不同
TestMain 中设置 gin.TestMode 是全局生效前提
只在某个测试函数里写 gin.SetMode(gin.TestMode) 无效——Gin 引擎启动后模式就固定了，必须在 TestMain 阶段设好。
- 新建
main_test.go，定义func TestMain(m *testing.M)，里面调用gin.SetMode(gin.TestMode)再m.Run() - 这个文件要和被测代码（如
main.go或router.go）在同一包下，否则无法访问未导出函数或变量 - 如果项目用了
gin.Default()，它自带Logger和Recovery中间件，测试时会输出日志干扰断言；建议测试专用路由用gin.New()+ 手动注册必要中间件
带参数的 Handler 要手动构造 req 并验证 c.Param/c.Query 行为
c.Param("id") 和 c.Query("name") 不是从字符串解析出来的，而是由 Gin 路由匹配器在 router.ServeHTTP 过程中注入到 c 的上下文里的。
- URL 参数：请求路径必须严格匹配路由定义，比如
router.GET("/users/:id", userHandler)，就要用http.NewRequest("GET", "/users/123", nil) - 查询参数：拼在 URL 后，如
/users/123?name=alice&role=admin，c.Query("name")才能取到"alice" - 别用
c.DefaultQuery或c.GetHeader做断言替代——它们只是辅助方法，真正要测的是路由和上下文是否按预期填充了数据
断言推荐用 testify/assert，但注意 JSONEq 对空白敏感
assert.Equal(t, `{"message":"pong"}`, w.Body.String()) 极易失败，因为 Go 的 map 序列化顺序不确定，且 gin.H 默认不加空格；而 assert.JSONEq 会忽略键序和空白，更可靠。
- 用
assert.JSONEq(t, `{"message":"pong"}`, w.Body.String())替代原始字符串比对 - 如果返回结构体，先用
json.Marshal转成字节再比对，避免字段顺序问题 - 状态码必须断言：
assert.Equal(t, http.StatusOK, w.Code)，很多 Handler 忘记设状态码，默认是 200，但错误路径可能返回 500 却没被发现
c.Param 取不到时的默认行为、没覆盖 BindJSON 失败路径、或者 mock 数据没重置导致前后测试污染。这些不会报错，但会让覆盖率虚高、线上出问题才暴露。 
