不能手动 new *gin.Context，因其依赖 gin.Engine 和响应写入器的完整生命周期管理，未导出字段未初始化会导致 panic 或功能异常；必须用 gin.CreateTestContext + httptest.ResponseRecorder 构造。
直接用 gin.CreateTestContext 构造，别手写或反射初始化 *gin.Context —— 否则会 panic 或行为异常。
为什么不能 new 出来一个 *gin.Context？
因为 *gin.Context 不是普通结构体，它内部持有未导出字段（如 writermem、handlers、index），且依赖 gin.Engine 和响应写入器的完整生命周期管理。手动初始化会导致：
-
c.JSON()、c.BindJSON()等方法调用时 panic：「nil pointer dereference」 -
c.Param()或c.Query()返回空值，即使你 mock 了Request - 中间件链无法执行，
c.Next()无效果
正确构造方式：用 gin.CreateTestContext + httptest.ResponseRecorder
这是 Gin 官方测试工具链推荐的唯一可靠路径。核心是把 *httptest.ResponseRecorder 作为响应写入目标，再由 gin.CreateTestContext 封装成可用的 *gin.Context：
import (
"net/http"
"net/http/httptest"
"github.com/gin-gonic/gin"
)
func TestAddUser(t *testing.T) {
// 1. 创建 recorder 捕获响应
w := httptest.NewRecorder()
// 2. 创建 gin context（关键！）
c, _ := gin.CreateTestContext(w)
// 3. 手动设置请求（必须！否则 c.Request == nil）
c.Request, _ = http.NewRequest("POST", "/user", strings.NewReader(`{"username":"test"}`))
c.Request.Header.Set("Content-Type", "application/json")
// 现在可以安全调用你的 handler
ctrl := NewUserController(mockUserService)
ctrl.AddUser(c)
// 断言
assert.Equal(t, 200, w.Code)
assert.Contains(t, w.Body.String(), "success")
}
-
gin.CreateTestContext会自动初始化所有内部字段，包括handlers链和index - 必须显式赋值
c.Request，否则c.BindJSON()会报invalid memory address - 如果 handler 里用了
c.Param("id")，需额外调用c.Params = gin.Params{gin.Param{Key: "id", Value: "123"}}
测试带中间件的路由时怎么处理？
如果你的 handler 被中间件包裹（比如 auth、logger），gin.CreateTestContext 默认不加载中间件链。此时有两种选择：
- 绕过中间件：直接调用 handler 函数，传入已构造的
*gin.Context（适用于单元测试逻辑层） - 走完整链路：用
gin.New()或gin.Default()创建 engine，注册路由和中间件，再用httptest.NewServer发真实请求（属于集成测试范畴，更重但更真实） - 折中方案：用
engine.ServeHTTP(w, req)模拟一次请求，它会触发完整中间件+路由匹配+handler 执行
例如：
r := gin.New()
r.Use(authMiddleware) // 假设你有这个中间件
r.POST("/user", ctrl.AddUser)
req, _ := http.NewRequest("POST", "/user", strings.NewReader(`{"username":"test"}`))
req.Header.Set("Content-Type", "application/json")
w := httptest.NewRecorder()
r.ServeHTTP(w, req) // ✅ 触发中间件和 handler
容易被忽略的 Context 细节
测试中真正容易翻车的不是构造本身，而是对 Context 生命周期的误判：
-
c.Value()和c.Set()是 per-request 的，每次CreateTestContext都是全新 map，不会跨测试用例残留 -
c.Errors是累积的，若 handler 中多次调用c.Error()，断言时得用c.Errors.Last()或遍历检查 -
c.GetBool("key")这类取值方法，底层依赖c.Keys，而Keys是 map[string]any，**key 类型必须是 string**；用 int 做 key 会导致静默失败 - 如果你在 handler 里用了
context.WithValue(c.Request.Context(), key, val)，测试时记得用c.Request = c.Request.WithContext(...)显式替换，否则新 context 不生效
