Fiber路由配错90%因混淆app.Use、app.Group、app.Get职责及忽略StrictRouting默认行为；StrictRouting:true使/users与/users/视为不同路径，需显式注册或重定向，而非关闭。
直接说结论：Fiber 路由配错，90% 是因为没分清 app.Use、app.Group、app.Get 的职责边界，以及忽略了 StrictRouting 的默认行为。装完就跑不起来？不是框架问题，是路径匹配逻辑没对齐。
Go 版本和模块初始化必须一步到位
Fiber v3 强制要求 Go 1.25+，用低版本会编译失败或运行时 panic；go mod init 也不是可选项——跳过它会导致 go get github.com/gofiber/fiber/v3 报 no required module provides package。
- 先执行
go version，若输出低于go1.25，用go install golang.org/dl/go1.25@latest && go1.25 download升级（别碰系统包管理器装的 Go） -
go mod init myapp（模块名全小写、无下划线） -
go get github.com/gofiber/fiber/v3—— 注意结尾是/v3，不是/v2或无后缀 - 验证代码里必须用
import "github.com/gofiber/fiber/v3"，handler 签名是func(c fiber.Ctx) error，不是*fiber.Ctx
StrictRouting 导致 /users 和 /users/ 被当成两个路由
默认 StrictRouting: true，所以注册了 app.Get("/users", h)，访问 /users/ 就是 404。这不是 bug，是设计：它防止前缀误匹配（比如关掉后 /users/123 可能被 /users 捕获）。
- 不推荐全局设
StrictRouting: false - 更稳妥的做法是加一个中间件统一处理尾部斜杠：
c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) - 或者前端、OpenAPI 文档、测试工具（如 Postman）全部约定用无尾斜杠路径，后端只注册一种形式
app.Use("/api") 和 app.Group("/api") 完全是两回事
app.Use("/api") 是中间件拦截：所有以 /api 开头的请求（无论 GET/POST/PUT），都先过这个中间件；它不注册 handler，也不影响后续路由注册路径。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
app.Group("/api") 是创建新路由树节点：返回一个 *fiber.Router，后续调用 api.Get("/users", h) 实际注册的是 GET /api/users —— 注意路径参数里写的是 /users，不是 /api/users。
- 常见错误：
api.Get("/api/users", h)→ 最终注册成/api/api/users，多了一层前缀 -
app.Use对所有 HTTP 方法生效；app.Group本身不绑定方法，只是组织子路由 - 中间件想只作用于某组路由？得挂到
app.Group返回的 router 上，而不是直接挂app.Use
ctx.Params、ctx.QueryParam、ctx.BodyParser 三者互不干扰
它们读取的数据来源完全隔离，混用必空值：
-
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)是专为 JSON 设计的，要求Content-Type是application/json；若前端发的是application/x-www-form-urlencoded，得换ctx.FormValue("name")
最常踩的坑是：路径里没定义 :id 却调 ctx.Params("id")，或者 POST JSON 时用 ctx.QueryParam 去读字段——结果永远是空字符串或零值。
