本文介绍如何使用 Gin 内置的 CreateTestContext 配合 httptest.NewRecorder() 构建可断言、可控制的测试用 *gin.Context，从而实现对控制器（Controller）层的单元测试，真正践行 TDD 开发流程。
本文介绍如何使用 gin 内置的 `createtestcontext` 配合 `httptest.newrecorder()` 构建可断言、可控制的测试用 `*gin.context`，从而实现对控制器（controller）层的单元测试，真正践行 tdd 开发流程。
在 Gin 应用中，*gin.Context 是处理 HTTP 请求与响应的核心对象，但它依赖底层 http.ResponseWriter 和 *http.Request，无法直接实例化。若强行构造空指针（如 &gin.Context{}），运行时会 panic。幸运的是，Gin 官方提供了安全、标准的测试上下文创建方式：gin.CreateTestContext()。
该函数接收一个 http.ResponseWriter 实现（推荐使用 httptest.NewRecorder()），返回 (ctx *gin.Context, w *httptest.ResponseRecorder) 元组，其中 w 可用于后续断言状态码、响应体等关键结果。
以下是完整、可运行的控制器测试示例（基于你提供的代码结构）：
package main
import (
"net/http"
"net/http/httptest"
"testing"
"github.com/gin-gonic/gin"
)
func TestControllerGetAll(t *testing.T) {
// 1. 设置 Gin 运行模式为测试模式（禁用日志/中间件干扰）
gin.SetMode(gin.TestMode)
// 2. 创建测试 ResponseWriter 和 Context
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
// 3. 准备 mock 仓库
repo := UserRepositoryMock{}
// 4. 执行被测方法
ctrl := UserController{}
ctrl.GetAll(c, repo)
// 5. 断言结果
if w.Code != http.StatusOK {
t.Errorf("期望状态码 %d，实际得到 %d", http.StatusOK, w.Code)
}
expected := `[{"Name":"Wilson"},{"Name":"Panda"}]`
if w.Body.String() != expected {
t.Errorf("期望响应体 %s，实际得到 %s", expected, w.Body.String())
}
}
func TestControllerGet(t *testing.T) {
gin.SetMode(gin.TestMode)
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
// 注意：需手动设置 URL 参数（因无真实路由匹配）
c.Params = []gin.Param{
{Key: "id", Value: "1"},
}
repo := UserRepositoryMock{}
ctrl := UserController{}
ctrl.Get(c, repo)
if w.Code != http.StatusOK {
t.Errorf("期望状态码 %d，实际得到 %d", http.StatusOK, w.Code)
}
expected := `{"Name":"Wilson"}`
if w.Body.String() != expected {
t.Errorf("期望响应体 %s，实际得到 %s", expected, w.Body.String())
}
}⚠️ 关键注意事项：
-
c.Params、c.Query、c.PostForm等字段不会自动填充，必须手动设置（如c.Params = []gin.Param{{"id", "1"}}），否则c.Param("id")将返回空字符串； - 若控制器中调用了
c.ShouldBindJSON()或其他绑定方法，需提前用c.Request = httptest.NewRequest(...)构造带 body 的请求； - 始终使用
gin.SetMode(gin.TestMode)避免开发/发布模式下的日志和 panic 处理干扰测试； -
httptest.NewRecorder()提供了.Code（状态码）、.Body.String()（响应体）、.Header()等完整断言能力，是验证控制器行为的核心工具。
通过这种方式，你可以完全解耦 HTTP 层与业务逻辑，专注测试 UserController 的行为是否符合预期——这才是 TDD 在 Gin 项目中落地的关键一步。
