Fiber路由核心是StrictRouting=true导致/users与/users/被视为不同路径,必须统一用重定向中间件301跳转或显式注册双路径;app.Use为方法无关前缀中间件,app.Group返回需手动拼全路径的独立路由实例。

app.Get、app.Post、app.Use、app.Group 这四个调用不是随便换着用的——选错一个,路由 404、参数取不到、中间件漏执行,三者必中其一。
为什么 app.Get("/users") 对 /users/ 返回 404?
Fiber 默认开启 StrictRouting: true,路径末尾斜杠被当作完全不同的路由。注册了 /users,就只匹配 GET /users;/users/ 是另一条未注册路径,直接 404。
别急着设 StrictRouting: false:关掉后,/users/123 可能被 /users 前缀错误捕获,因为松散匹配会触发不精确路由回退。
- 推荐做法:在所有路由前加统一重定向中间件,对非根路径且以
/结尾的请求做 301 跳转:c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) - 更稳妥的协同方式:前端、OpenAPI 文档、Postman 全部约定使用无尾斜杠路径,后端只注册一种形式(如全用
/users,不用/users/)
ctx.Params("id")、ctx.QueryParam("q")、ctx.BodyParser(&v) 到底读哪来的数据?
三者来源完全隔离,混用必然空值。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
ctx.Params("id")只从路径占位符提取,例如app.Get("/user/:id", h)匹配/user/123后才可取到"123";对/user?id=123或 JSON body 无效 -
ctx.QueryParam("q")只解析 URL query string,例如/search?q=go→"go";不碰路径、header、body -
ctx.BodyParser(&v)是专为application/json设计的;若请求是application/x-www-form-urlencoded,得换ctx.FormValue("name")
app.Use 和 app.Group 的本质区别在哪?
app.Use 是前缀级中间件挂载,对所有 HTTP 方法生效;app.Group 是独立路由树节点,用于组织带公共前缀的子路由,但不自动拼接路径。
立即学习“go语言免费学习笔记(深入)”;
-
app.Use("/api")表示:所有以/api开头的请求(无论 GET/POST/PUT),都先过这个中间件;它不注册 handler,只是拦截 -
api := app.Group("/api")返回一个新*fiber.Router,后续调用api.Get("/users", h)实际注册的是GET /api/users—— 注意:路径参数里必须写全/users,不能省略前缀,Fiber 不会帮你补 - 常见错误:
api.Get("/api/users", h)→ 最终变成/api/api/users,多了一层
动态路由和通配符怎么写才不踩坑?
Fiber 支持路径参数、可选参数、通配符,但语法敏感,稍错就匹配失败。
-
app.Get("/user/:id", h):匹配/user/123,但不匹配/user/或/user -
app.Get("/user/:id?", h):问号表示:id可选,但仅限单个参数;多个可选需拆成独立路由或用正则 -
app.Get("/files/*", h):星号通配符匹配剩余全部路径段,c.Params("*")可取到完整子路径,如访问/files/a/b/c→"a/b/c" - 复杂匹配建议用正则:例如
app.Get("/user/:id([0-9]+)", h)强制id为数字,避免类型错误透传到业务层


















