Fiber 无路由别名机制，/v1/users 与 /api/v1/users 是两条独立路由；需用 Group 统一前缀或中间件重定向实现类似效果。
Fiber 没有“路由别名”这个概念，所谓别名其实是路径注册方式、中间件重定向或分组前缀的误用结果；直接搜“Fiber alias route”会踩进文档盲区。
为什么 app.Get("/v1/users") 和 app.Get("/api/v1/users") 不是别名关系
Fiber 的路由注册是精确字符串匹配（受 StrictRouting 控制），不存在自动映射或别名解析机制。你写两条相同 handler 的路由：
app.Get("/v1/users", h)
app.Get("/api/v1/users", h)
它们就是两条完全独立的路由，不共享参数、不互相 fallback、也不触发重定向——只是重复注册了两次 handler。
- 想让
/v1/users自动跳转到/api/v1/users？得自己加中间件做 301 重定向 - 想统一前缀管理？该用
app.Group("/api")，而不是靠“别名”幻想 - 前端调用
/v1/users却收到 404？不是框架没配别名，是你根本没注册这条路径
app.Group() 是最接近“逻辑别名”的实用替代方案
app.Group() 返回一个新路由实例，所有后续 .Get/.Post 都自动拼接前缀，但它不是别名，而是路径构造工具：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
api := app.Group("/api")
api.Get("/users", userHandler) // 实际注册的是 GET /api/users
api.Post("/posts", postHandler) // 实际注册的是 POST /api/posts
- 别写
api.Get("/api/users", ...)——这会导致双倍前缀/api/api/users - 分组本身不改变路由语义，它只是帮你少敲几个字符，避免手误漏写前缀
- 如果需要多版本共存（如
/v1/和/v2/），就建两个 group：v1 := app.Group("/v1")、v2 := app.Group("/v2")
用中间件模拟“软别名”：比如把 /users 重定向到 /api/users
这不是配置别名，而是显式控制请求流向。适合兼容旧路径、收敛入口、或统一 API 网关行为：
app.Use(func(c fiber.Ctx) error {
path := c.Path()
if path == "/users" || path == "/users/" {
return c.Redirect("/api/users", 301)
}
return c.Next()
})
- 必须放在所有
.Get/.Post注册之前，否则不会生效 - 注意
StrictRouting：若开启（默认），/users/和/users是两个路径，都要判断 - 别用
return c.SendStatus(200)冒充别名——那只是返回内容，URL 不变，SEO 和前端 history 都会出问题
真正容易被忽略的点：路径参数和 query 的隔离性会影响“别名感”
你以为 /user/:id 和 /api/user/:id 是同一套参数逻辑？其实不是。哪怕 handler 完全一样，c.Params("id") 的提取只依赖当前注册路径的结构：
-
app.Get("/user/:id", h)→ 能取到c.Params("id")，但无法访问c.QueryParam("format")（除非 URL 带 query） -
app.Get("/api/user/:id", h)→ 同样能取c.Params("id")，但路径不匹配时连 handler 都进不去 - 没有全局参数映射表，也没有“别名参数透传”机制——每个路由是独立的数据上下文
所以别指望靠改个路径前缀就自动复用所有参数提取逻辑；handler 内部该检查 c.Params() 还是 c.QueryParam()，一点都不能少。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
