Gin单元测试需用httptest构造真实请求上下文，不可手动创建*gin.Context；必须通过gin.Engine.ServeHTTP触发完整路由与中间件链，并显式注册依赖的中间件，正确使用ShouldBind及结构体tag，覆盖率应聚焦handler/service/utils等业务目录。
Gin 框架的单元测试不需要额外框架也能跑通，但直接用 testing 包写断言容易漏掉边界、难覆盖中间件逻辑、mock HTTP 上下文也容易出错——这些问题在 gin-vue-admin 这类真实项目里反复出现。
用 httptest 构造真实请求上下文
很多人直接 new 一个 *gin.Context 去测 handler，结果 panic 报 nil pointer dereference。Gin 的 context 必须由 engine 初始化并绑定到 request 上，不能手动构造。
正确做法是用 Go 标准库 net/http/httptest 搭配 gin.Engine.ServeHTTP：
- 创建
httptest.NewRequest和httptest.NewRecorder - 调用
engine.ServeHTTP(recorder, req)触发完整路由+中间件链 - 从
recorder.Body.String()或recorder.Code断言响应
示例片段：
func TestUserLogin(t *testing.T) {
r := gin.New()
r.POST("/login", userHandler.Login)
req, _ := http.NewRequest("POST", "/login", strings.NewReader(`{"username":"a","password":"b"}`))
req.Header.Set("Content-Type", "application/json")
w := httptest.NewRecorder()
r.ServeHTTP(w, req)
assert.Equal(t, 200, w.Code)
}
中间件测试必须显式注册
单独测某个 handler 时，如果它依赖 c.MustGet("user_id") 这类中间件注入的值，不注册中间件就会 panic。Gin 不会自动帮你补全上下文数据。
常见错误写法：r.NoRoute(handler) 后直接测，但没加 auth 中间件；结果 c.Get("user_id") 返回空，后续逻辑崩了。
- 测试带中间件的路由，必须在 test router 上
Use()对应中间件 - 可 mock 中间件行为，比如用
func(c *gin.Context) { c.Set("user_id", uint(123)) } - 避免在测试中调用真实 JWT 解析或 DB 查询，用 set + stub 替代
Bind 类方法要小心结构体 tag 和空值处理
c.ShouldBindJSON() 或 c.ShouldBind() 在测试中容易因结构体字段 tag 写错、缺失 form/json 标签，或未设默认值导致绑定失败返回 400，但你可能只检查了 status code 而没看 body 内容。
- 确保结构体字段有对应 tag，例如
Name string `json:"name" form:"name"` - 测试空字符串、零值、缺失字段时，
ShouldBind默认不报错，但业务逻辑可能依赖非空校验，得靠Verify或自定义 validator 补足 - 别用
MustBind测异常路径——它会直接 panic，无法断言错误类型
覆盖率统计要排除测试文件和路由注册代码
go test -coverprofile=cover.out ./... 容易把 main.go 里的 r := gin.New()、r.Use(...) 这些初始化代码也纳入统计，拉低实际业务逻辑覆盖率。
真正该关注的是 handler、service、utils 这些目录下的函数分支是否被触发，尤其是 error path 和 early return。
建议限定目录执行：
go test -coverprofile=cover.out ./server/handler ./server/service ./server/utils
再用 go tool cover -html=cover.out 查看，重点关注红色未覆盖行——它们往往是没测到的 if err != nil 分支或 panic 情况。
