Golang Fiber框架路由分组配置完整教程-Golang-PHP中文网

Fiber 的 app.Group() 不自动拼接前缀，必须显式写全路径；分组中间件仅作用于本组且无法按方法过滤；StrictRouting 为 true 时 /users 和 /users/ 视为不同路由，应统一路径规范或加重定向中间件；批量注册需复用同一 group 实例。

golang fiber框架路由分组配置完整教程

app.Group() 不是自动拼前缀，必须写全路径

Fiber 的 app.Group() 返回的是一个独立的 *fiber.Router 实例，它不修改你传入的子路由路径——也就是说，api := app.Group("/api") 后，api.Get("/users", h) 注册的是 GET /api/users；但如果你写成 api.Get("users", h)，实际注册的是 GET /users，请求 /api/users 就直接 404。

常见错误包括：

api.Get("/api/users", h) → 注册为 /api/api/users，多了一层前缀
嵌套调用 app.Group("/v1").Group("/admin").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)）。

但要注意：

不能在 group.Use() 里靠 c.Method() 判断后 return 来跳过某个方法——因为 Use 是前置拦截，一旦 return，后续路由匹配就终止了
如果要做 POST 限流但 GET 不限，得拆成两个分组，或改用路由级中间件
若限流依赖用户角色（如 VIP 阈值不同），必须确保鉴权中间件（写入 c.Locals）在 group.Use(limiter) 之前注册，否则 limiter 拿不到 role

StrictRouting 导致 /users 和 /users/ 都 404？别关它，加重定向

Fiber 默认 StrictRouting: true，意味着 /users 和 /users/ 是两条完全不同的路由。你只注册了 app.Get("/users", h)，那访问 /users/ 必然 404——这不是 bug，是设计。

别用 fiber.New(&fiber.Config{StrictRouting: false}) 临时绕过，它会让 /users/:id 和 /users/ 冲突，比如请求 /users/123 可能被 /users 错误捕获，c.Params("id") 拿不到值。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

推荐做法是加统一中间件，在所有路由注册前处理：

app.Use(func(c *fiber.Ctx) error {
    path := c.Path()
    if strings.HasSuffix(path, "/") && path != "/" {
        // 保留 query string
        uri := c.Request().URI()
        full := uri.FullURI()
        clean := strings.TrimSuffix(string(full), "/")
        return c.Redirect(clean, fiber.StatusMovedPermanently)
    }
    return c.Next()
})

或者更简单：上线前统一约定前端、OpenAPI、Postman 全部用无尾斜杠路径，后端只注册一种形式。

批量注册路由时，别在循环里重复调用 app.Group()

用切片批量注册 API 时，常见错误是把 app.Group() 放进 for 循环里，导致每次新建一个 *fiber.Router 实例，最终只有最后一次循环的路由被注册。

正确方式是复用同一个 group 变量：

api := app.Group("/api") // ← 只调用一次
for _, r := range routes {
    switch r.Method {
    case "GET":
        api.Get(r.Path, r.Handler) // r.Path 必须含前缀，如 "/users"
    case "POST":
        api.Post(r.Path, r.Handler)
    }
}

关键点：