必须用路由分组绑定中间件实现权限拦截：Group()自动合并路径前缀，支持传参或Use()挂载；中间件需按序执行、显式调用c.Next()和c.Abort()；全局与分组中间件叠加执行，权限校验须在中间件内完成而非依赖路径前缀。
要在Gin中实现对特定API路径范围（如/admin或/api/v1）的统一权限拦截和逻辑前置处理，必须正确将中间件绑定到路由分组而非拼接路径或依赖前缀伪装。
路由分组创建与路径前缀自动合并
调用 r.Group("/admin") 创建分组，返回一个 *gin.RouterGroup 实例；该实例注册的所有子路由路径会自动与前缀合并，无需手动重复书写。
例如：v1 := r.Group("/api/v1") → 后续写 v1.GET("/users", handler)，最终生效路径是 【/api/v1/users】，不是 /api/v1//users 或 /api/v1/api/v1/users。
前缀字符串必须以单个 / 开头，且不能以 // 或尾部多余斜杠结尾，否则可能导致路由匹配失败或重定向异常。
分组级中间件绑定的两种写法
方法一：在 Group() 调用时直接传入中间件函数
admin := r.Group("/admin", AuthMiddleware(), LoggerMiddleware())
方法二：先创建分组，再调用 .Use() 显式挂载
admin := r.Group("/admin")admin.Use(AuthMiddleware(), LoggerMiddleware())
两种方式等价，但方法二更利于条件判断——比如仅在非开发环境挂载日志中间件。
中间件执行顺序与流程控制关键点
第一步：多个中间件按传入顺序依次进入（洋葱模型外层→内层）
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
第二步：每个中间件内必须显式调用 c.Next() 才能继续向内执行后续中间件或最终 handler
第三步：若权限校验失败，须立即调用 c.Abort() 中断流程，否则请求仍会抵达业务 handler —— 【漏掉 c.Abort() 可能导致未授权用户执行删库、转账等敏感操作】
第四步：c.Next() 之后的代码属于“响应阶段”，可用于记录耗时、修改响应头、补充日志等。
全局中间件与分组中间件的叠加关系
全局中间件（r.Use()）和分组中间件（group.Use()）会按注册顺序串联执行，不是覆盖关系。
例如：全局注册了 Recovery() 和 Logger()，分组又注册了 JWTAuth()，则完整执行链为：Logger → JWTAuth → handler → Logger（响应阶段），而 Recovery 始终包裹最外层。
注意：如果不想让未通过鉴权的请求被记日志，就不能把 Logger 放在 JWTAuth 之前——应将日志中间件移至鉴权之后，或在鉴权中间件中动态控制是否记录。
权限控制必须靠中间件，不能只靠路径前缀
r.Group("/admin") 本身不提供任何访问控制能力，它只是组织路由的容器。
普通用户仍可直接请求 GET /admin/users，只要没挂载鉴权中间件或中间件里没做 role 字段校验，请求就会直达 handler。
真实权限逻辑需在中间件中解析 token、提取 role、比对白名单，并在不满足时调用 c.AbortWithStatusJSON(403, gin.H{"error": "forbidden"}) 主动终止。
