生产项目应使用Fiber v2（go get github.com/gofiber/fiber/v2），需Go 1.21+；必须用fiber.New()初始化，禁用fiber.Default()；StrictRouting默认开启导致路径严格匹配，/users与/users/视为不同路由。
go get 静默失败、fiber.Default() 启动 panic、v2/v3 混用导致编译报错——这些问题基本都卡在 Go 版本、初始化方式或模块路径上，不是 Fiber 本身坏了。
Go 版本不匹配导致 go get 失败或依赖拉取错误
Fiber v3 要求 go version 1.24+，v2 支持最低 go 1.21+。用 go version 检查后发现低于要求，go get 会跳过兼容检查、静默拉取旧版或失败。
- 运行
go install golang.org/dl/go1.24@latest下载新版 Go 工具链，再执行go1.24 download - 别用系统包管理器（如 apt/yum）装 Go，它常滞后；优先用
golang.org/dl/或官方二进制 - 确认
GOBIN在$PATH中，否则go1.24命令不可用
fiber.Default() 启动就 panic 或日志刷屏
fiber.Default() 不是“快捷启动”，它是开发调试用的预设实例，自带 Logger、Recover、RequestID 三个中间件。生产环境一跑就满屏 Authorization 头、TTFB 拖慢 0.5ms+、I/O 扛不住。
- 上线服务必须用
fiber.New()初始化空实例 - 若需日志，改用采样式：只记录
c.Status() >= 400的请求，或对接systemd-journald - 关掉 banner：
fiber.New(fiber.Config{DisableStartupMessage: true})
v2 和 v3 混用引发编译错误或 undefined 报错
当前（2026 年 10 月）v3 仍是测试阶段，文档、工具链、CI/CD 镜像均未对齐。混用 github.com/gofiber/fiber/v2 和 github.com/gofiber/fiber/v3 会导致类型不兼容、函数找不到、fiber.NewWithCustomCtx 等新 API 编译失败。
- 生产项目一律用 v2：
go get github.com/gofiber/fiber/v2 - import 路径必须严格匹配，不能写
import "github.com/gofiber/fiber"（缺版本号） - 检查
go.mod是否出现两行 fiber 依赖；有则手动删掉 v3 行，再go mod tidy
路由注册后 404，但代码看起来完全正确
这不是安装问题，而是初始化后默认行为没对上：Fiber 默认开启 StrictRouting: true，且 fiber.Default() 自带中间件干扰了路径匹配逻辑。你看到的 404 很可能源于 /users 和 /users/ 被当成两个路由，而你只注册了一个。
- 别关
StrictRouting，那会让/users/:id和/users/冲突 - 统一重定向：在所有路由前加中间件，检测
c.Path()是否以/结尾且长度 > 1，是则c.Redirect(strings.TrimSuffix(c.Path(), "/"), fiber.StatusMovedPermanently) - 确保
fiber.Recover()注册在所有路由之前，否则 panic 会直接退出进程
fiber.New() 是唯一能让你看清中间件、路由、错误处理全链路的起点。其他所有“方便”封装，都会在某个压测凌晨三点悄悄反噬。
