中间件执行顺序由use()调用时序决定，与分组定义先后无关：先调用v1.use()则其中间件排前，后调用v2.use()则排后；分组仅封装路径前缀，不改变中间件在全局链中的插入位置。
中间件执行顺序由注册位置决定，不是按分组定义顺序
很多人误以为 r.Group("/v1") 和 r.Group("/v2") 的定义先后会决定中间件执行顺序。实际上，Gin 的中间件链是线性拼接的：谁先调用 Use()，谁就排在前面；分组只是路由前缀的封装，不改变中间件注册时序。
常见错误现象：在 v1 := r.Group("/v1") 里注册了日志中间件，又在 v2 := r.Group("/v2") 里注册了鉴权中间件，结果发现所有请求都先走日志、再走鉴权——哪怕只访问 /v2 路径。这是因为两个中间件都是通过 v1.Use() 和 v2.Use() 注册的，而 v1.Use() 先执行，所以它被插入到整个链更靠前的位置。
- 中间件链是全局单向链表，
Use()调用即刻追加，与分组层级无关 -
Group()返回的是新路由树节点，其Use()只影响该分组下的 handler，但执行时机仍服从全局链顺序 - 若想让某分组独享中间件（且不干扰其他分组），必须确保该中间件只在该分组内注册，且不在父引擎或其它分组重复注册
全局中间件 vs 分组中间件：作用域和覆盖逻辑要分清
在 gin.New() 或 gin.Default() 创建的引擎上调用 Use()，属于全局中间件，对所有后续注册的路由（含所有分组）生效；而在某个 Group() 实例上调用 Use()，只对该分组及其子分组内的 handler 生效。
容易踩的坑是“重复拦截”：比如你在引擎级注册了 gin.Logger()，又在 v1 分组里再注册一次自定义日志中间件，结果每个 /v1 请求会被记两次日志；而 /v2 请求只记一次（仅引擎级那次）。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 全局中间件无法被分组中间件“屏蔽”，只能被跳过（如用
SkipPaths配置） - 分组中间件不会自动继承父级中间件的配置参数（例如自定义
LoggerConfig不会透传） - 若需统一行为但差异化控制，建议用函数工厂模式生成中间件实例，避免状态污染
洋葱模型下，中间件的“进入”和“退出”阶段不能错配
Gin 的中间件是典型的洋葱模型：请求进来时从外向内逐层执行 c.Next() 前代码；响应返回时从内向外逐层执行 c.Next() 后代码。这个对称性一旦破坏，就容易出现 panic、日志错位、header 写入失败等问题。
典型错误是在分组中间件里忘记调用 c.Next()，或者在 c.Next() 后继续操作已写入的 response body（比如又调用 c.JSON()）。尤其当多个分组嵌套（如 v1.Auth().Group("/user")）时，各层中间件的进出点必须严格对应。
- 每个中间件函数体内，
c.Next()最多调用一次，且应放在逻辑主干中段 - 在
c.Next()前可修改c.Request或设置上下文值（c.Set()）；之后可读取处理结果、记录耗时、写 header - 不要在
c.Next()后调用c.Abort()，这会中断外层中间件的“退出”阶段，导致 recovery 失效或日志不全
版本分组路由中，中间件隔离最容易被忽略的三个细节
像 /api/v1 和 /api/v2 这类版本分组，常默认共用一套中间件，但实际业务中 v2 往往需要新鉴权方式、不同限流策略或额外审计字段。这时候如果只靠路径前缀区分，很容易漏掉关键隔离点。
最常被忽略的是中间件内部的状态复用问题：比如一个 JWT 解析中间件缓存了 token payload 到 c.Keys，但 v1 和 v2 对同一字段语义不同（v1 的 scope 是字符串，v2 改为数组），结果 v2 handler 读到了 v1 格式的旧值。
- 跨版本中间件尽量无状态，或显式用版本号做 key 前缀（如
c.Set("v2_user_id", id)） - 避免在中间件里直接修改
c.Request.URL或重写c.Request.Header，这会影响下游所有分组 - 测试时务必覆盖混合路径：比如同时请求
/api/v1/users和/api/v2/users，观察中间件是否各自独立触发、无交叉污染
