应使用 httptest.NewRecorder 拦截 Gin 响应：先用 httptest.NewRequest 构造请求，再调 engine.ServeHTTP(recorder, req)；recorder.Body.String() 仅在响应写入后有效，需确保 handler 未 panic 或提前返回。
怎么用 httptest.NewRecorder 拦截 Gin 的 HTTP 响应
Gin 本身不提供内置的 Mock HTTP 客户端，但 Go 标准库的 httptest 能直接对接它的 Engine.ServeHTTP 方法。关键不是“发起请求”，而是把请求塞进去、把响应扣下来。
常见错误是试图用 http.Get 测试本地路由——这会绕过 Gin 中间件、无法控制上下文（比如 c.Set 注入的数据），也测不到 panic 捕获逻辑。
- 必须用
httptest.NewRequest构造请求，再传给engine.ServeHTTP(recorder, req) -
httptest.NewRecorder()返回的*httptest.ResponseRecorder是个“假响应体”，它把状态码、Header、Body 全缓存在内存里，可随时断言 - 注意：
recorder.Body.String()只在响应写入完成后才有效；如果 handler panic 或提前 return，Body 可能为空
Gin 的 c.ShouldBindJSON 在测试里为什么总报 invalid memory address
这不是 JSON 解析失败，而是测试时没给 *gin.Context 绑定合法的 Request 和 Writer —— ShouldBindJSON 内部会调用 c.Request.Body，而测试中若只 new 出空 context，c.Request 是 nil。
- 正确做法：用
gin.CreateTestContext+httptest.NewRequest组合，它会自动补全Request和Writer - Body 必须设为
bytes.NewReader(jsonBytes)，不能只设Content-Type: application/json却不写 Body - 如果结构体字段没加
json:tag，绑定会静默失败（字段保持零值），建议配合err := c.ShouldBindJSON(&v)显式检查
Mock 数据库依赖：用接口隔离 + gomock 还是直接替换 func 变量
Gin handler 里直接调数据库（比如 db.QueryRow）会让测试难解耦。推荐用函数变量替换，比接口+gomock 更轻、更贴近真实调用链。
立即学习“go语言免费学习笔记（深入）”；
- 把 DB 调用封装成包级变量，如
var GetUserByID = func(id int) (*User, error) { ... } - 测试前用
defer恢复原函数：old := GetUserByID; defer func() { GetUserByID = old }() - gomock 适合已有稳定 interface 的场景（如
repository.UserRepo），但 Gin handler 层通常没 interface 抽象，硬套反而增加维护成本 - 注意：全局函数变量在并发测试中可能污染，务必每个 test case 独立重置
断言 JSON 响应时，assert.JSONEq 和 assert.Equal 选哪个
assert.Equal 对比原始字符串，对换行、空格、字段顺序敏感；assert.JSONEq（来自 github.com/stretchr/testify/assert）先解析再比较 AST，容忍格式差异，更适合 API 响应断言。
- 错误示例：
assert.Equal(t, `{"id":1,"name":"a"}`, recorder.Body.String())—— 一旦后端加个空格或改字段顺序就挂 - 正确做法：
assert.JSONEq(t, `{"id":1,"name":"a"}`, recorder.Body.String()) - 如果响应含时间戳或 UUID 等动态字段，别硬比完整 JSON，改用
json.Unmarshal后单独 assert 关键字段
最常被忽略的是中间件执行顺序——测试时若漏掉 engine.Use()，像 JWT 验证、日志、recover 这些逻辑全不会触发，结果看似通过，实则线上行为完全不同。
