Go测试未运行导致go test -cover显示0.0%：需确认_test.go命名规范、Test函数签名正确、在被测包目录下执行、go test -v验证是否识别测试，且Gin handler测试须手动构造异常请求路径覆盖error分支。
go test -cover 显示 0.0% 不是覆盖率低，是测试根本没跑
这在 Gin 项目里太常见了：你写了 handler_test.go，函数也以 Test 开头，但 go test -cover 依然输出 coverage: 0.0% of statements。这不是代码难测，而是测试压根没被识别。
检查这几项：
-
_test.go文件名必须严格以_test.go结尾（不是test_handler.go或handler_tests.go） - 测试函数必须以
Test开头，且参数类型为*testing.T（不是testLogin或RunHandlerTest） - 确保在**被测代码所在包目录**下执行命令（比如
internal/user/，而不是项目根目录；go test -cover默认不递归子包） - 先跑
go test -v，确认输出里有=== RUN TestXXX；没有就说明测试函数没被发现
httptest.NewRequest 必须手动构造异常路径，否则 error 分支永远不覆盖
Gin handler 里的 if err != nil、context.DeadlineExceeded、json.Unmarshal 失败等逻辑，靠自然请求几乎不可能触发。不手动构造，这些分支就是红色未覆盖。
实操建议：
- 用
httptest.NewRequest("POST", "/login", nil)触发空 body 导致的BindJSON错误 - 构造非法 JSON：
httptest.NewRequest("POST", "/user", strings.NewReader(`{"id":}`)) - 测试超时路径：创建已 cancel 的 context：
ctx, cancel := context.WithCancel(context.Background()); cancel()，再用gin.CreateTestContext注入 - 对依赖（DB、cache）用
testify/mock或gomock注入两次行为：一次返回正常值，一次返回errors.New("timeout")
验证 binding tag 时，结构体字段必须带 json tag 和 binding tag
Gin 的 ShouldBind 或 Bind 方法依赖字段的 json 和 binding tag 才能正确校验。漏掉任一个，校验就失效，测试会误判。
常见错误写法：
type UserForm struct {
Name string `binding:"required"`
}
// ❌ 缺少 json tag，BindJSON 无法映射字段，校验不生效
正确写法：
type UserForm struct {
Name string `json:"name" binding:"required"`
Age int `json:"age" binding:"required,gt=0,lte=150"`
}
测试时还要注意：
- 用
gin.CreateTestContext(httptest.NewRecorder())创建上下文，别直接 new *gin.Context - 调用
c.ShouldBind(&form)后检查err != nil，而非只看form值 - 错误信息字符串要匹配实际输出（如
"Key: 'Name' Error:Field validation for 'Name' failed on the 'required' tag"），别硬写模糊断言
中间件测试不能只测“通路”，要隔离依赖并验证上下文变更
比如日志中间件、JWT 验证中间件、请求 ID 注入中间件——它们不返回 HTTP 响应，而是修改 c.Request.Context() 或 c.Keys。只测状态码会漏掉关键逻辑。
实操要点：
- 不要把中间件和路由绑在一起测；单独传入一个 mock context：
c, _ := gin.CreateTestContext(httptest.NewRecorder()) - 调用中间件函数后，检查
c.Get("user_id")、c.MustGet("auth_token")等键是否存在且值正确 - 对 JWT 中间件，要构造含伪造签名、过期时间、缺失 header 的 token，验证是否提前 return
- 若中间件依赖外部服务（如 Redis 校验黑名单），必须 mock 它；否则测试不稳定且慢
defer resp.Body.Close() 这类清理逻辑，但测试中 handler 提前 return（比如校验失败），defer 就不会执行——这会导致资源泄漏或测试假阳性。临时改成显式关闭 + 日志：if err := resp.Body.Close(); err != nil { t.Log(err) }，才能暴露问题。 
