用 httptest 测试 Gin Handler 的正确方法是创建 httptest.NewRequest 和 httptest.NewRecorder，调用 router.ServeHTTP，并务必设置 gin.SetMode(gin.TestMode)；需正确注册路由、设置请求头（如 Content-Type、Authorization）、使用 assert.JSONEq 比对 JSON 响应，并通过接口抽象和 fake 实现解耦依赖。
怎么用 httptest 测试 Gin Handler？
直接上手就是创建 httptest.NewRequest 和 httptest.NewRecorder，再把请求喂给 router.ServeHTTP —— 这是 Gin 单元测试最稳的路径，不依赖真实网络、不启动服务，纯内存级验证。
常见错误：忘了调 gin.SetMode(gin.TestMode)，导致日志刷屏、中间件行为异常（比如重定向被触发）；或者漏掉 router.GET("/xxx", handler) 注册，结果 404 却以为逻辑错了。
- 必须在
TestMain或每个测试函数开头设gin.TestMode，否则gin.Default()会加载调试中间件干扰断言 - URL 参数要用
:/id形式注册路由，查询参数拼在请求 URL 后（如"/users/123?name=test"），别试图手动塞进c.Param - POST JSON 请求记得设置
req.Header.Set("Content-Type", "application/json")，否则c.ShouldBindJSON直接报错
如何测带中间件的路由？
中间件不是黑盒——它和 Handler 一样走 router.ServeHTTP 流程，关键在于“是否注册”和“顺序是否对”。测 Auth 中间件时，别只盯着 token 格式，更要验证它是否真的阻断了非法请求。
典型翻车点：写了 router.Use(AuthMiddleware())，但测试请求没带 Authorization 头，结果 200 返回成功，误以为中间件失效；其实是中间件根本没触发拒绝逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 合法场景：
req.Header.Set("Authorization", "Bearer xxx")→ 断言w.Code == http.StatusOK - 非法场景：不设 header 或设错格式（如
"token xxx"）→ 断言w.Code == http.StatusUnauthorized - 如果中间件依赖外部服务（如 Redis 检查 token），必须用
gomock或接口抽象 + fake 实现，否则测试变集成测试
为什么 assert.JSONEq 比 assert.Equal 更可靠？
因为 JSON 字段顺序不保证，Go map 序列化后 key 排序随机。用 assert.Equal(t, `{"a":1,"b":2}`, w.Body.String()) 极易因字段顺序抖动失败，而 assert.JSONEq 会解析后比对结构，容忍空格、换行、key 顺序差异。
实操中还常忽略响应体编码：如果 Handler 用了 c.Data 或写入二进制内容，w.Body.String() 可能乱码，此时应改用 w.Body.Bytes() 配合 bytes.Equal。
- 永远优先选
assert.JSONEq测 JSON 响应，除非你明确要校验原始字符串格式（比如 Swagger JSON Schema 输出） - 遇到中文返回乱码？检查 Handler 是否显式设了
c.Header("Content-Type", "application/json; charset=utf-8") - 测试表（test table）驱动多个输入输出组合时，
assert.JSONEq能大幅减少误报
测试覆盖率低，是不是没 mock 数据库？
不是。覆盖率低往往是因为没覆盖分支路径，比如 if err != nil { return } 的错误分支压根没触发。数据库 mock 是集成测试的事，单元测试里该用 interface + fake 实现，而不是真连 DB。
一个高频盲区：Handler 里调用的 service 层函数，如果直接 new struct 调用，就切不断依赖。必须把 service 定义为接口，Handler 通过参数注入，测试时传入 fake 实现。
- 别在测试里跑
go test -cover看整体覆盖率，用go test -coverprofile=c.out && go tool cover -html=c.out定位具体哪行没跑过 - 边界值必须测：空字符串、负数 ID、超长 body、
nil返回值 —— 这些才是拉高覆盖率又防线上 panic 的关键 - 用
testify/mock或手写 fake 时，重点 mock **副作用操作**（DB 写、HTTP 调用、文件 IO），纯计算逻辑没必要 mock
