必须使用 go get github.com/gofiber/fiber/v2@v2.50.0，因 Go 模块要求 major 版本体现在路径中；不加 /v2 会导致 +incompatible 错误及运行时 panic。
直接用 go get 加版本号即可，但必须带 /v2 或 /v3 路径后缀，否则拉不到正确模块。
为什么 go get github.com/gofiber/fiber@v2.50.0 会失败
Go 模块系统要求 Fiber 的 major 版本必须体现在导入路径中。不写 /v2 就等于告诉 Go：“我要的是 v0/v1 兼容版”，而 Fiber 从 v2 起就彻底弃用了 v0/v1 的导入路径。
常见错误现象：go get github.com/gofiber/fiber@v2.50.0 表面成功，但 go.mod 里写的是 github.com/gofiber/fiber v2.50.0+incompatible，实际运行时 panic 报错 cannot use fiber.New (value of type *fiber.App) as *fiber.App value in return statement——这是模块解析错乱的典型表现。
- 必须显式使用
github.com/gofiber/fiber/v2路径 - 版本号要跟在
@后，不能混在路径里（比如/v2@v2.50.0是错的） - v3 目前（2026年10月）仍属测试阶段，生产项目别碰
/v3
go get 拉指定 v2 小版本的正确命令
例如安装稳定可用的 v2.50.0：
go get github.com/gofiber/fiber/v2@v2.50.0
执行后检查 go.mod 是否出现这一行：
github.com/gofiber/fiber/v2 v2.50.0
不是 +incompatible 结尾，才算真正锁定成功。
- 如果项目已存在
go.mod且已有旧版 Fiber，建议先go mod edit -droprequire github.com/gofiber/fiber/v2再重拉，避免残留冲突 - 别用
go get -u，它会无视你指定的版本，自动升级到最新 minor/patch - 拉完记得
go mod tidy，清理未引用的间接依赖
怎么验证当前用的是哪个版本
运行 go list -m github.com/gofiber/fiber/v2，输出形如：
github.com/gofiber/fiber/v2 v2.50.0
如果显示 v2.49.0 或 latest，说明没锁住——大概率是 go get 命令漏了 @vX.Y.Z，或 go.mod 被其他依赖覆盖了版本声明。
- 不要依赖
fiber.Version变量，它只反映编译时的版本常量，不保证运行时加载的就是这个 - CI/CD 中建议加一行
test "$(go list -m github.com/gofiber/fiber/v2 | awk '{print $2}')" = "v2.50.0"做版本断言 - 历史版本发布页在 GitHub 的
https://github.com/gofiber/fiber/releases，v2 所有 tag 都可追溯
版本锁定这事看着简单，但 Fiber 的模块路径设计和 Go 的语义化版本规则咬得特别紧——差一个 /v2 或多一个 -u，就可能让整个服务启动失败。动手前先 go list -m 看一眼当前状态，比盲试快得多。
