测试Gin路由时应避免gin.Default()，因其默认注册Logger和Recovery中间件，会干扰断言、捕获panic并写日志到os.Stdout，导致测试失败或卡死；正确做法是用gin.New()创建干净引擎，手动添加必要中间件。
测试Gin路由时为什么gin.Default()会导致测试失败
因为gin.Default()默认注册了gin.Recovery()和gin.Logger()中间件，它们会直接写日志到os.Stdout、捕获panic并终止测试流程。单元测试里你没法控制终端输出，更不能让一次panic中断整个测试套件。
正确做法是用gin.New()创建一个干净的引擎，手动添加必要中间件（通常测试中连gin.Logger()都该去掉）：
router := gin.New() // 仅在需要验证中间件逻辑时才加，比如鉴权测试 // router.Use(authMiddleware)
常见错误现象：panic: runtime error: invalid memory address或测试卡死无输出——大概率是Recovery吞了panic又没暴露出来。
如何模拟HTTP请求并检查响应内容
Gin提供httptest.NewRecorder()配合router.ServeHTTP()完成无网络请求的端到端路由测试，不依赖真实HTTP服务器启动。
立即学习“go语言免费学习笔记（深入）”；
关键步骤：
- 用
gin.CreateTestContext()或直接构造*http.Request（推荐后者，更可控） - 调用
router.ServeHTTP(recorder, req)触发路由逻辑 - 从
recorder.Body.String()读响应体，用recorder.Code断言状态码
示例：
req, _ := http.NewRequest("GET", "/api/user/123", nil)
req.Header.Set("Accept", "application/json")
w := httptest.NewRecorder()
router.ServeHTTP(w, req)
assert.Equal(t, 200, w.Code)
assert.Contains(t, w.Body.String(), `"id":123`)
注意：如果路由含路径参数（如:id），http.NewRequest传的URL必须带实际值，Gin不会自动注入参数——这是新手最常漏掉的一点。
测试带JSON请求体的POST接口时怎么传数据
Go标准库http.NewRequest第二个参数是io.Reader，不能直接传struct，得先序列化为字节流，并设好Content-Type头。
实操建议：
- 用
json.Marshal()把结构体转[]byte，再用bytes.NewReader()包装 - 务必设置
req.Header.Set("Content-Type", "application/json") - 若接口用
c.ShouldBindJSON()，没这个Header会导致400 Bad Request且无明确错误提示
示例：
payload := map[string]interface{}{"name": "alice", "age": 30}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "/api/user", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
w := httptest.NewRecorder()
router.ServeHTTP(w, req)
容易踩的坑：用strings.NewReader(`{"name":"alice"}`)但忘了设Header，结果Gin跳过JSON绑定，字段全零值。
如何隔离测试间的全局状态（比如数据库连接、中间件变量）
Gin本身无全局状态，但你的业务代码很可能有——比如在init()里初始化DB、或在中间件里往c.Keys塞共享数据。测试时这些状态会跨测试函数残留。
解决方式分三层：
- 对DB：每个测试用
testdb（如github.com/DATA-DOG/go-sqlmock）或内存SQLite，测完sqlmock.ExpectationsWereMet() - 对中间件依赖：用
c.Set("user_id", 123)预设上下文键值，而不是依赖真实鉴权流程 - 对全局变量：测试前重置（如
config.Port = 0），或用函数选项模式把依赖显式传入handler
性能影响：每次测试新建DB连接很慢，务必复用连接池或用mock；gin.Context本身轻量，不用刻意复用。
真正麻烦的是第三方SDK的单例（比如Redis client、Prometheus register），它们往往没提供Reset方法——这时候只能接受“单测跑完不清理”，靠CI环境隔离来规避污染。
