app.Group()不是自动补前缀的魔法盒子，而是返回独立*fiber.Router实例，子路由必须显式写全路径（如"/users"），否则注册为根路径导致404；嵌套Group易致路径失控，应统一用完整前缀如app.Group("/v1/admin")。
app.Group() 是配置路由前缀的唯一正确方式
Fiber 没有“自动补前缀”的魔法，app.Group() 返回的是一个独立的 *fiber.Router 实例，它只提供上下文隔离和中间件作用域，**不修改你传入的路径字符串**。你写什么路径，就注册什么路径——它不会帮你把 "users" 变成 "/api/users"，也不会拒绝你写 "/api/api/users"。
常见错误是误以为 Group 会智能拼接：
-
api := app.Group("/api")→ 正确：后续必须写api.Get("/users", h)才匹配GET /api/users -
api.Get("users", h)→ 错误：注册的是GET /users，不是/api/users，请求/api/users直接 404 -
api.Get("/api/users", h)→ 错误：注册的是GET /api/api/users，多了一层前缀
嵌套 Group 容易导致路径失控，别这么干
语法上允许 app.Group("/v1").Group("/admin")，但它会让路径来源分散、重构时极易出错。比如：
v1admin := app.Group("/v1").Group("/admin")v1admin.Get("/dashboard", h) → 实际匹配 /v1/admin/dashboard
问题在于：前缀被拆成两段，调试时看不出完整路径；中间件执行顺序也变隐晦（外层 Group 的 Use() 先于内层）；CI/CD 中 diff 路径变更时容易漏掉某一层。
立即学习“go语言免费学习笔记（深入）”；
更稳妥的做法是：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用变量一次性定义完整前缀：
v1admin := app.Group("/v1/admin") - 所有子路由路径写全量，如
v1admin.Get("/dashboard", h) - 中间件统一挂载在该变量上：
v1admin.Use(authMw)
前缀 + 中间件 + 批量注册，三步统一管理
真实项目中，API 前缀往往伴随鉴权、限流、日志等中间件，且接口数量多。推荐结构如下：
api := app.Group("/api")
api.Use(cors.New(), logger.New()) // 统一中间件
v1 := api.Group("/v1")
v1.Use(authMw) // v1 级专属中间件
v1.Get("/users", getUsers)
v1.Post("/users", createUser)
v2 := api.Group("/v2")
v2.Use(authMw, rateLimiter) // 可叠加不同中间件
v2.Get("/users", getUsersV2)
关键点：
-
app.Group()和group.Use()是绑定关系：子 Group 自动继承父 Group 的中间件 - 批量注册时，**必须复用同一个 group 变量**，不能在循环里反复赋值
g := app.Group(...)，否则只保留最后一次注册 - 若需动态注册（如从 YAML 加载），确保 handler 类型为
fiber.Handler，并避免闭包陷阱（用func(h fiber.Handler) fiber.Handler包一层）
StrictRouting 对前缀的影响常被忽略
前缀路径末尾带斜杠时，StrictRouting: true（默认）会让 /api 和 /api/ 成为两条路由。比如：
api := app.Group("/api")api.Get("/users", h) → 注册 /api/users，但 /api//users 或 /api/users/ 都 404
这不是 Group 的问题，而是整个路由树都受 StrictRouting 控制。解决方法只有两个：
- 在所有 Group 之前加重定向中间件：
app.Use(func(c fiber.Ctx) error { if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { return c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) } return c.Next() }) - 或统一约定：OpenAPI、前端 SDK、Postman 全部使用无尾斜杠路径，后端只注册一种形式
别关 StrictRouting: false —— 它会让 /api/users/:id 被 /api/users 错误捕获，c.Params("id") 拿不到值，问题更隐蔽。
