Gin路由分组不自动继承父组中间件，必须显式传入或调用Use()；Group()仅共享路径前缀，子组Handlers为空切片，需system := v1.Group("/system", v1.Handlers...)或system.Use(...)才能生效。
多级路由分组本身不会自动继承父组中间件，必须显式调用 Use() 才能传递中间件链 —— 这是 Gin 中最常被误解的一点。
为什么 v1.Group("/system") 不会自动拥有 v1 的中间件
Gin 的 Group() 方法只继承前缀路径和当前已注册的中间件列表（即父组调用 Use() 后累积的 handlers），但子组初始化时自身 Handlers 是空的。它不“自动复制”父组中间件，除非你主动传进去。
-
v1 := router.Group("/v1")创建后，v1.Handlers是空切片（除非你立刻v1.Use(...)） -
system := v1.Group("/system")创建时，system的Handlers也是空切片，和v1无关 - 只有写成
system := v1.Group("/system", v1.Handlers...)或显式system.Use(...)，中间件才会生效 - 官方示例中看似“继承”，其实是开发者手动把父组中间件传给了子组，不是框架行为
Group() 的参数到底怎么传中间件
所有 Group() 方法签名都是 func (g *RouterGroup) Group(relativePath string, handlers ...HandlerFunc) *RouterGroup，第二个可变参数才是中间件入口。
- 正确写法：
system := v1.Group("/system", authMiddleware, logMiddleware) - 错误写法：
system := v1.Group("/system"); system.Use(authMiddleware)—— 这样system确实有了中间件，但v1自身仍无，且父子之间无绑定关系 - 若想复用父组中间件，可直接展开：
system := v1.Group("/system", v1.Handlers...)，但要注意v1.Handlers是指针引用，后续修改会影响子组 - 更安全的做法是封装中间件为变量：
commonMWs := []gin.HandlerFunc{authMiddleware, logMiddleware}，然后在v1和system中分别传入
路由匹配优先级与分组嵌套的实际影响
Gin 匹配路由时只看完整路径字符串是否精确匹配，不关心分组层级结构。所谓“更具体路径优先”，本质是注册顺序 + 路径长度共同决定的，和分组嵌套无直接关系。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
- 先注册
v1.GET("/users", ...)，再注册system.GET("/users", ...)，后者实际路径是/v1/system/users，比前者长，自然更精确 - 但如果先注册
system.GET("/status", ...)，再注册v1.GET("/status", ...)，请求GET /v1/status仍会命中后者 —— 因为它是第一个匹配上的/v1/status - 分组嵌套只是组织代码的手段，不影响底层
radix tree的节点插入顺序 - 调试时可用
router.Routes()查看所有已注册路由，确认实际路径和顺序
中间件执行顺序：洋葱模型 + 分组边界
中间件执行严格遵循“注册顺序 + 洋葱模型”，但每个分组的 Use() 只影响该组内注册的路由 handler，不会穿透到兄弟或父组。
- 全局
router.Use(a, b)→ 所有路由（包括分组内）都会先执行 a、再 b -
v1.Use(c)→ 只对v1内注册的路由生效（如v1.GET("/x", h)） -
system.Use(d)→ 只对system内注册的路由生效（如system.GET("/y", h)） - 一个请求
GET /v1/system/y的执行链是：a → b → c → d → handler（前提是v1和system都没跳过中间件） - 中间件里调用
c.Next()才会进入下一层；漏掉c.Next()就会中断整个链，后续中间件和 handler 都不执行
真正容易出问题的地方在于：你以为子组自动继承了父组中间件，结果测试时发现认证没生效、日志没打、甚至 panic 恢复失效 —— 其实只是忘了在 Group() 调用里显式传参，或者误以为 Use() 有作用域继承性。Gin 的设计是显式优于隐式，这点必须刻进本能。
