生产项目应使用fiber v2（go get github.com/gofiber/fiber/v2），因其支持go 1.21+、生态稳定；v3需go 1.24+且仍为测试阶段，须严格匹配版本与import路径，初始化用fiber.new()而非fiber.default()，strictrouting默认开启导致/users与/users/被视为不同路径。
Go 1.24 以下别装 v3，生产项目直接用 v2；没升级 Go 就执行 go get，大概率静默失败或拉错版本。
检查 Go 版本再动手
运行 go version 看输出。如果低于 go1.24（比如显示 go version go1.23.5），就别碰 v3——它强制要求 1.24+，且当前仍是测试阶段。v2 支持到 go1.21+，文档、CI 工具、中间件生态都稳定得多。
升级 Go 的实操建议：
- 用
go install golang.org/dl/go1.24@latest下载新版安装器 - 再执行
go1.24 download完成安装 - 验证：运行
go1.24 version确认成功，再切回系统默认go命令前，先用which go和go env GOROOT检查是否已切换
选对命令：v2 是生产默认，v3 需显式声明
绝大多数项目该用这个命令装 v2：
go get github.com/gofiber/fiber/v2
v3 只在明确需要尝鲜 HTTP 客户端、新绑定系统等特性时才考虑，且必须同步满足两个条件：
- Go 版本 ≥
1.24 - import 路径必须写成
github.com/gofiber/fiber/v3，不能和 v2 混用（否则编译报错）
常见错误：复制了 v3 示例代码但没改 import，或本地 Go 还是 1.23 却硬跑 v3 安装命令——结果依赖拉下来了，go build 时直接卡在 fiber/v3 找不到。
初始化别用 fiber.Default()，从 fiber.New() 开始
fiber.Default() 看似省事，但默认挂了 Logger、Recover、RequestID 三个中间件，上线后会立刻暴露问题：
- 每条请求都记完整日志，含
Authorization、Cookie等敏感头，I/O 直接拖垮 QPS - TTFB 实测增加 0.3–0.8ms，在高并发下不可忽略
-
Recover默认开启堆栈打印，可能泄露路径或内部结构
正确做法是：
- 用
app := fiber.New()创建空实例 - 开发阶段可临时加
logger.New()，但只在ENV == "debug"时启用 - 生产环境用
recover.New(recover.Config{EnableStackTrace: false})关掉堆栈
第一个路由跑不通？先看 StrictRouting 和斜杠
注册了 app.Get("/users", handler)，但访问 /users/ 返回 404，不是代码错了，是 Fiber 默认 StrictRouting: true——它把 /users 和 /users/ 当作两个不同路径。
关掉 StrictRouting 是最危险的解法：当同时存在 /users 和 /users/:id 时，/users/123 可能被前者匹配，c.Params("id") 拿不到值，排查成本极高。
推荐方案只有两个：
- 显式注册两条：
app.Get("/users", handler)和app.Get("/users/", redirectHandler) - 加统一重定向中间件：
if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) }
这个细节在本地调试常被忽略，一上 Nginx 或 CDN 就暴露——因为前端 SDK、OpenAPI 文档、Postman 请求路径不一致，线上 404 频发。
