Gin的Group()仅返回子路由引擎，不自动注册路由；测试必须用完整路径（如"/api/v1/users"）并显式调用子路由方法，否则404。
测试带 Group 的路由必须显式注册整个分组路径
Gin 的 router.Group() 本身不注册任何路由，只是返回一个子路由引擎；如果你只在 group 里注册了 GET("/list")，但没把 group 挂到主 router 上（比如 v1 := router.Group("/api/v1") 后漏掉 v1.GET(...) 或根本没调用 v1），测试时会直接 404——这不是 handler 逻辑问题，而是路由树压根没建起来。
常见错误是写完 v1 := router.Group("/api/v1") 就去测 "/list"，结果请求发到 "/list" 而不是 "/api/v1/list"，断言失败却以为是 handler 绑定出错。
- 正确做法：测试请求 URL 必须完整匹配分组前缀 + 子路由，例如 group 是
/api/v1、子路由是GET("/users")，测试时必须用"/api/v1/users" - 别在测试里“猜”路径拼接逻辑，直接看
router.Group(...).GET(...)的实际调用链 - 如果分组嵌套（如
v1.Group("/admin").GET("/dashboard")），路径就是/api/v1/admin/dashboard，少一级都 404
Group 带中间件时，测试必须触发中间件逻辑
分组中间件（如 v1.Use(AuthMiddleware())）和全局中间件一样走 router.ServeHTTP 流程，但它的生效前提是：请求路径命中该 group 的所有前缀，且中间件注册顺序正确。测试时若跳过中间件所需头或状态，它就静默放行，导致你以为“中间件没起作用”，其实是没满足拒绝条件。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- Auth 中间件测试：必须设置
req.Header.Set("Authorization", "Bearer xxx")，否则可能直接 200 返回（中间件未触发校验逻辑） - 权限中间件测试：构造非法 token 或过期 token，断言返回
http.StatusUnauthorized，而不是只测正常流程 - 中间件依赖外部服务（如 DB/Redis）：必须用接口抽象 + fake 实现，否则测试会变集成测试，不稳定且慢
测试 Group 里的参数路由要严格匹配注册格式
Gin 的参数绑定依赖路由定义时的占位符写法。比如 v1.GET("/users/:id") 才支持 c.Param("id")；如果误写成 v1.GET("/users/{id}") 或 v1.GET("/users?id=123")，c.Param("id") 永远为空，测试断言会失败，但错误信息不明显。
- URL 参数必须用
:name格式注册，测试请求路径写成"/api/v1/users/123"，不能靠 query string 传参来模拟 - Query 参数（如
?page=1&size=10）要拼在测试 URL 后，和分组路径一起构成完整地址："/api/v1/users/123?page=1" - Body 参数（JSON/form）不受 group 影响，但记得设
Content-Type头，否则c.ShouldBindJSON直接报错
assert.JSONEq 是唯一安全的 JSON 响应比对方式
Go 的 map 序列化后 key 顺序不固定，用 assert.Equal(t, `{"code":0,"msg":"ok"}`, w.Body.String()) 极易因字段顺序抖动失败。而 assert.JSONEq 会解析两边 JSON 后结构化比对，忽略空格、换行、key 顺序。
- 永远别用
w.Body.String()直接比原始字符串，尤其当响应含时间戳、随机 ID 等动态字段时 - 如果 handler 返回二进制或自定义编码内容（如
c.Data），改用w.Body.Bytes()配合bytes.Equal - 测试前务必调用
gin.SetMode(gin.TestMode)，否则日志刷屏、重定向中间件干扰断言
分组测试最常被忽略的点是：**你以为在测 handler，其实是在测路由注册是否完整、路径拼接是否准确、中间件触发条件是否满足**。这三个环节任何一个漏掉，测试失败原因和业务逻辑完全无关。
