必须用 app.Group(),因为Fiber无独立Router对象,仅通过app.Group()返回* fiber.Group(实现Router接口)来构建分组;手动拼路径导致前缀散落、中间件难复用,且嵌套路径自动拼接、StrictRouting默认开启需注意斜杠边界。

必须用 app.Group(),别手拼路径字符串,也别试图导出 Router 实例
为什么只能用 app.Group()?
Fiber 没有 app.Router()、app.Route() 或类似 Express 的独立 Router 对象。所有分组都必须通过 app.Group() 构建,它返回一个 *fiber.Group,该类型实现了 Router 接口,所以能直接调用 .Get()、.Post() 等方法。
常见错误是手动拼接路径,比如:
api := app // 错误:这不是分组,只是 app 本身
api.Get("/api/users", handler) // 路径硬编码,中间件无法批量绑定
api.Get("/api/posts", handler)
这会导致前缀逻辑散落、中间件重复注册、后续加版本号(如 /v2)时要改十几处。
正确做法是:
-
api := app.Group("/api")—— 前缀自动拼接,api.Get("/users")实际注册为/api/users - 斜杠边界由框架保证,不用纠结
/api还是/api/(但注意 StrictRouting 默认开启,二者不等价) - 分组本身不响应请求,若需
/api/根路径行为,必须显式写api.Get("/", handler)
app.Group() 的中间件必须在创建时传入
分组级中间件(比如鉴权、日志)必须作为参数传给 app.Group(),不能事后调 .Use()。
例如:
// ✅ 正确:中间件作用于整个 /admin 分组下的所有子路由
admin := app.Group("/admin", authMiddleware)
<p>// ❌ 错误:admin.Use() 注册的是一个匹配 /admin/* 的额外路由,不是分组级中间件
admin := app.Group("/admin")
admin.Use(authMiddleware) // 这会干扰 /admin 根路径,且执行时机错乱
</p>
多个中间件按顺序执行:
-
api := app.Group("/api", logger, jwtAuth)→ 先logger,再jwtAuth - 某条路由需要额外中间件(如 IP 白名单),可单独加:
api.Delete("/user", ipWhitelist, handler) - 分组中间件只影响该分组内显式注册的子路由(即调用了
.Get()等的方法),不影响其他路径
嵌套分组和路径拼接规则
app.Group() 支持链式嵌套,路径自动拼接,末尾斜杠会影响匹配结果(因 StrictRouting 默认为 true)。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
示例:
v1 := app.Group("/v1")
admin := v1.Group("/admin") // 最终前缀是 /v1/admin
admin.Get("/users", handler) // 实际注册为 /v1/admin/users
<p>// 注意:/v1 和 /v1/ 是两个不同分组
v1Slash := app.Group("/v1/") // 不等于 /v1
v1Slash.Get("/users", handler) // 注册为 /v1//users(双斜杠,通常不想要)
</p>
关键点:
- 嵌套调用是安全的,框架内部处理好路径拼接与去重斜杠
- 不要在子路径开头加斜杠:
admin.Get("/users")✅,admin.Get("users")也 ✅(Fiber 会自动补前导斜杠),但admin.Get("//users")❌ - 若需关闭严格匹配,启动时设
fiber.Config{StrictRouting: false},但不推荐,易引发歧义
如何把路由抽到独立文件里?
别把所有 app.Group() 写进 main.go。标准做法是新建 routers/ 目录,每个文件负责一个业务域。
比如 routers/user.go:
package routers
<p>import "github.com/gofiber/fiber/v3"</p><p>func SetupUserRoutes(app *fiber.App) {
user := app.Group("/user")
user.Get("/list", listHandler)
user.Get("/detail/:id", detailHandler)
}
</p>
然后在 main.go 中调用:
func main() {
app := fiber.New()
routers.SetupUserRoutes(app) // 显式挂载
app.Listen(":3000")
}
注意:
- 函数名必须首字母大写(
SetupUserRoutes),才能被外部包调用 - 不要在路由函数里调
app.Listen()或重复初始化 - 中间件若只用于某组路由,就放在对应路由文件里传入
app.Group();全局中间件(如 CORS、Recover)才放在main.go靠前位置
最常被忽略的是 StrictRouting 的默认行为——写 app.Group("/api") 和 app.Group("/api/") 会注册两套完全隔离的路由,调试时 404 却找不到原因,往往就卡在这儿。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










