fiber的group不是路径修饰器，而是返回独立的*fiber.router实例；必须显式在子路由中写全量路径（如/api/users），漏写或重复拼接前缀是初学者常见错误。
分组不是自动拼前缀，而是给你一个带上下文的新路由实例；漏写路径前缀或重复拼接是 90% 的初学者错误。
Group 返回的是 *fiber.Router，不是路径修饰器
Fiber 的 app.Group("/api") 返回一个独立的 *fiber.Router 实例，它和 app 行为一致（能链式调用 Use、Get），但不修改任何路径逻辑。它不会帮你把 "/users" 自动变成 "/api/users"——你必须自己写全路径。
- ✅ 正确：
api := app.Group("/api"); api.Get("/users", handler)→ 匹配GET /api/users - ❌ 错误：
api := app.Group("/api"); api.Get("/api/users", handler)→ 匹配GET /api/api/users - ⚠️ 注意：
app.Group("")或app.Group("/")是合法的，但前者等价于根路由，后者在部分 fasthttp 版本中可能触发边界匹配歧义，建议统一用空字符串或明确前缀
嵌套 Group 容易导致路径失控
虽然 app.Group("/v1").Group("/admin") 在语法上可行，返回的也是 *fiber.Router，但它会让路径构造变得隐晦且难调试。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 路径必须逐层显式拼接：若写成
v1admin := app.Group("/v1").Group("/admin"); v1admin.Get("/dashboard", h)，实际匹配的是/v1/admin/dashboard，但前缀分散在两处，重构时极易遗漏 - 中间件叠加顺序也变复杂：外层
Group的中间件会先执行，内层再执行，但错误日志里看不出嵌套层级 - 推荐替代方案：用变量一次性定义前缀，例如
v1admin := app.Group("/v1/admin")，路径和中间件都集中管理
分组中间件只对本组内路由生效，且无法按 HTTP 方法过滤
Group.Use() 注册的中间件，仅作用于该组注册的所有路由（Get、Post、Put 等全部方法），不会泄漏到其他分组或根路由。
- 执行顺序固定：全局中间件（
app.Use()）→ 组级中间件（group.Use()）→ 路由级中间件（group.Get("/x", mw, h)） - 无法跳过某个方法：比如你只想对
POST限流，不能在group.Use(limiter)里判断c.Method()后 return，因为Use是前置拦截，必须放行才能进路由匹配；真要按方法区分，得拆成多个分组或改用路由级中间件 - 鉴权后才该挂限流：若限流需依赖用户角色（如 VIP 与普通用户不同阈值），务必确保鉴权中间件（写入
c.Locals）在Group.Use(limiter)之前注册，否则 limiter 拿不到role只能 fallback 到 IP
别混淆 app.Use 和 Group —— 前者是方法无关的通配挂载，后者是路由组织单元
app.Use("/api", middleware) 和 app.Group("/api") 看似相似，但底层机制完全不同：
-
app.Use("/api", m)是前缀挂载：所有以/api开头的请求（无论 GET/POST/DELETE）都会经过该中间件，哪怕后面路径根本没注册路由（如/api/xxx），它也会执行并可能返回 404 前的日志或鉴权逻辑 -
app.Group("/api")是纯路由组织：它不产生任何中间件行为，只是提供一个新Router实例，用来注册真实存在的路由；没注册的路径，连中间件都不会触发 - 混合使用场景：常见做法是
app.Use("/api", logger)全局记录 API 请求，再用v1 := app.Group("/v1")分版本管理具体路由，两者互补而非替代
最常被忽略的一点：Group 不处理路径参数解析，也不影响 :id 或 *path 的匹配规则——那些全由 Fiber 的路由引擎在注册时静态编译，分组前后行为完全一致。路径写错，报错信息也不会提示“分组导致”，只会安静地 404。
