测试gin路由组时中间件不生效，需确保gin.testmode已设置、use()调用在路由注册前、路径匹配精确且routes()输出验证无误。
测试 Gin 路由组时中间件不生效？先确认 gin.TestMode 和 engine.Use() 顺序
Gin 默认在测试时不会自动加载中间件，哪怕你写了 r.Use(middleware)，如果测试用的 gin.Engine 实例没显式调用 Use() 或没正确构造路由组，中间件就根本不会触发。常见错误是直接用 gin.New() 创建 engine，然后手动注册 handler，却忘了把中间件也挂上去。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 测试前必须用
gin.SetMode(gin.TestMode)，否则日志和 panic 行为会影响断言 - 中间件要通过
engine.Use()全局注册，或在engine.Group()后对 group 调用Use()—— 单独写group.Use()不等于整个 group 自动继承，它只影响该 group 下后续注册的路由 - 别在测试里复用生产环境的
gin.Default()，它自带Logger()和Recovery()，会干扰响应体和状态码
怎么模拟带中间件的请求？用 httptest.NewRequest + engine.ServeHTTP
Gin 的测试本质是黑盒 HTTP 测试：构造请求、喂给 engine、检查响应。中间件是否运行，取决于请求是否经过对应路由路径和方法，而不是“手动调用中间件函数”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
httptest.NewRequest("GET", "/api/v1/users", nil)构造请求，路径必须匹配你注册的路由（比如group.GET("/users")对应/api/v1/users） - 用
rec := httptest.NewRecorder()接收响应，再调用engine.ServeHTTP(rec, req)—— 这一步才真正触发路由匹配 + 中间件链 + handler 执行 - 中间件里常用的
c.Next()或c.Abort()行为，会如实反映在rec.Code和rec.Body.String()里，比如鉴权中间件返回 401，rec.Code就是 401
中间件依赖外部服务（如 Redis、DB）？必须在测试中替换或打桩
真实中间件常含 c.Get("user_id")、c.MustGet("db").QueryRow(...) 这类逻辑。测试时若不处理，要么 panic（key 不存在），要么连不上 DB 导致超时失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 避免在中间件里直接 new DB/Redis 客户端；改用从
c.MustGet("db")取，测试时用c.Set("db", mockDB)注入 mock - 对基于 context 的中间件（如
func(c *gin.Context) { c.Next() }），可在测试中提前c.Set("auth_token", "valid")模拟已认证状态 - 别用
monkey.Patch打桩全局函数——Gin 中间件执行上下文是*gin.Context，打桩函数无法感知 c 的生命周期，容易漏掉 abort 场景
为什么测试能过但线上中间件不执行？检查 router.Group() 的嵌套和路径前缀
典型现象：本地跑 curl http://localhost:8080/api/v1/users 正常，但单元测试发 /api/v1/users 却 404，或者中间件完全没日志输出。问题往往出在路由组的路径拼接上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
api := r.Group("/api")再api.Group("/v1")，最终路由是/api/v1/xxx；但如果测试时请求的是/v1/xxx，就会 404 - 中间件注册位置决定作用域：在
r.Use(mw)注册，所有路由都走；在api.Use(mw)注册，只覆盖/api/**；在v1.Use(mw)注册，只覆盖/api/v1/** - 用
engine.Routes()打印全部注册路由（测试里加一行t.Log(engine.Routes())），比猜路径更可靠
中间件的执行链是静态注册 + 动态匹配的结果，路径错一位、method 错一个字母、甚至多一个尾部斜杠，都会让中间件彻底失效。别信“应该差不多”，得看 Routes() 输出和 rec.Code 实际值。
