Gin单元测试不应起HTTP服务器，而应使用httptest.NewRequest和httptest.NewRecorder进行内存级测试；必须设gin.TestMode，正确构造路径、查询、请求头，用ShouldBindJSON和assert.JSONEq断言，中间件需显式注册并覆盖合法/非法场景。
Gin 的单元测试不该起 HTTP 服务器，接口集成测试才需要真实端口监听；混淆这两者会导致测试慢、不稳定、断言失效。
用 httptest.NewRequest + httptest.NewRecorder 做纯内存级单元测试
handler 是普通函数，不依赖网络——直接调 router.ServeHTTP(w, req) 即可验证逻辑。起 router.Run() 或 httptest.NewServer() 是集成测试做法，单元测试里这么做等于绕开 Gin 的设计优势。
- 必须在测试开头设
gin.SetMode(gin.TestMode)，否则gin.Default()会注入Logger和Recovery，干扰响应体和 panic 捕获 - URL 参数（如
/user/:id）直接写路径值："/user/123"，Gin 会自动解析进c.Param("id") - Query 参数拼在 URL 后：
"/users?limit=10&offset=0"，或手动赋值req.URL.RawQuery = "limit=10" - POST JSON 请求必须设 header：
req.Header.Set("Content-Type", "application/json")，否则c.ShouldBindJSON直接返回错误 - 别用
c.BindJSON()做单元测试——它失败时自动写 400 响应并中断执行；改用c.ShouldBindJSON()，把错误处理权拿回来自己断言
测中间件要显式注册，且区分合法/非法请求场景
测试文件里的 gin.Engine 是干净实例，r.Use(authMiddleware) 不会自动继承 main 中的配置。漏注册中间件，最常见后果是：线上 401，测试却返回 200。
- 合法请求：带正确
Authorization头 → 断言w.Code == http.StatusOK - 非法请求：不设头、头格式错（如
"token xxx"而非"Bearer xxx"）、token 过期 → 断言w.Code == http.StatusUnauthorized或http.StatusForbidden - 中间件若依赖外部服务（如 Redis 验证 token），必须用接口抽象 + fake 实现，不能直连真实服务，否则测试变集成测试
- 日志、panic 捕获类中间件可跳过，除非你专门测它们的行为
用 assert.JSONEq 比对响应，别信 assert.Equal 的字符串匹配
Go 的 map 序列化后 key 顺序不固定，assert.Equal(t, `{"a":1,"b":2}`, w.Body.String()) 极易因字段顺序抖动失败。
- 永远优先用
assert.JSONEq(t, expected, w.Body.String())，它解析 JSON 后比结构，容忍空格、换行、key 顺序差异 - 如果 handler 返回二进制内容（如
c.Data），w.Body.String()可能乱码，此时该用w.Body.Bytes()配合bytes.Equal - 测试响应体前，先断言状态码：
assert.Equal(t, http.StatusOK, w.Code)，否则 400 错误可能被忽略成“空响应成功”
接口集成测试才该监听真实端口，但需控制生命周期
集成测试目标是验证整个 HTTP 流水线：路由注册、中间件链、绑定、序列化、网络层。这时才用 httptest.NewServer() 或真实 :8080 端口，但必须确保端口不冲突、服务可关闭。
- 用
httptest.NewServer(SetupRouter())启服务，测试末尾defer ts.Close()，避免端口泄漏 - 真实端口测试（如
router.Run(":3000")）仅限 CI 中隔离环境，本地开发慎用——容易端口占用、难 debug - 集成测试里仍要设
gin.SetMode(gin.TestMode)，否则日志刷屏影响 CI 日志可读性 - 别在集成测试里 mock DB 或调第三方 API——那是单元测试干的事；集成测试就该走真实依赖，暴露链路问题
最容易被忽略的是：单元测试中中间件注册与请求构造的严格对应关系。一个 router.Use() 漏掉，或一个 req.Header.Set() 忘写，测试就失去意义——它不再反映线上行为，只是在测一个虚构的干净世界。
