必须先清理旧依赖再重装：用go mod edit -droprequire逐个删除fiber旧版本，删go.sum中相关行，再go mod tidy；确认Go≥1.24，升级后执行go env -w GOROOT=$(go1.24 env GOROOT)，最后go get github.com/gofiber/fiber/v2并用fiber.New()初始化。
Fiber 安装失败或运行时报 undefined symbol 错误，基本就是旧版本残留 + Go 版本不匹配导致的。必须先清理再重装，不能跳步。
检查并强制清理 fiber 相关旧依赖
go get 不会自动覆盖或卸载旧版本，v2.28 和 v2.49 可能共存，导致符号冲突（比如 fiber.NewWithCustomCtx 找不到）。清理不是“删掉 vendor”，而是让 Go modules 彻底遗忘旧引用：
- 运行
go mod graph | grep fiber查看当前项目实际加载的 fiber 版本（注意输出里可能有多个github.com/gofiber/fiber/v2@v2.28.0这类行） - 逐个执行
go mod edit -droprequire github.com/gofiber/fiber/v2（重复执行直到go mod graph | grep fiber无输出） - 删掉
go.sum中所有含gofiber/fiber的行（用文本编辑器或sed -i '/gofiber\/fiber/d' go.sum） - 最后运行
go mod tidy—— 此时应提示 “require github.com/gofiber/fiber/v2: not found”
确认 Go 版本 ≥ 1.24 再安装 v2
v2 要求最低 Go 1.21，但 1.24 是实测最稳的版本。低于 1.21 时 go get github.com/gofiber/fiber/v2 会静默拉取不兼容分支（如 v2.49.x 降级为 v2.28），且不报错：
- 执行
go version，若显示go1.20.14或更低，必须升级 - 运行
go install golang.org/dl/go1.24@latest && go1.24 download - 验证：
go1.24 version应输出go version go1.24.x - 切回系统默认 Go：
go env -w GOROOT=$(go1.24 env GOROOT)
重新安装 v2 并验证初始化方式
装完后立刻验证是否真用了新版本，且没引入旧习惯：
- 执行
go get github.com/gofiber/fiber/v2—— 不要加-u，否则可能意外升级到 v3 预发布版 - 检查
go.mod：应出现github.com/gofiber/fiber/v2 v2.50.0（2026 年 10 月最新稳定版） - 代码中只允许用
fiber.New()初始化，禁用fiber.Default()（它默认带 Logger/Recover/RequestID，开发期干扰重载输出，生产期拖慢 QPS） - 写一行测试路由：
app.Get("/health", func(c *fiber.Ctx) error { return c.SendString("ok") })，跑go run main.go访问/health确认通
最容易被忽略的是：清理后没重跑 go mod tidy，或升级 Go 后没执行 go env -w GOROOT=...，导致 go 命令仍调用旧版本编译器 —— 这会让前面所有操作白做。
