Go环境需≥1.16且GO111MODULE=on；国内网络应设GOPROXY=https://goproxy.cn,direct；清理modcache后指定v2.52.0版本拉取；多版本冲突时用replace统一。
在使用 Go 语言开发 Fiber 应用时，执行 go get -u github.com/gofiber/fiber/v2 报错、超时、校验失败或提示 module lookup failed，说明依赖包安装流程被阻断，必须逐层定位网络、代理、Go 模块配置或版本兼容性问题。
检查 Go 环境与模块模式是否启用
运行 go version 确认 Go 版本 ≥ 1.16（Fiber v2 要求最低 Go 1.16）；若低于该版本，需先升级 Go。接着执行 go env GO111MODULE，输出必须为 【on】，否则 go get 不走模块路径，会尝试写入 $GOPATH/src，导致找不到 v2 子模块。
若为 auto 或 off，立即执行：go env -w GO111MODULE=on。
解决国内网络导致的拉取超时或 403 错误
GitHub 域名在部分网络环境下解析慢或被限流，直接 go get 会卡在 fetching 或返回 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
方法一：启用 GOPROXY（推荐）
执行：go env -w GOPROXY=https://goproxy.cn,direct。
注意：结尾的 direct 是关键，它保证私有仓库仍直连，不走代理。
方法二：临时跳过校验（仅调试用）
执行：go env -w GOSUMDB=off。
【生产环境严禁开启】，否则无法校验包完整性，可能引入恶意代码。
修复 v2 版本路径识别失败
Fiber v2 使用语义化导入路径 github.com/gofiber/fiber/v2，但部分旧项目残留 v1 缓存或未清理 vendor，会导致 go get 找不到匹配模块。
第一步：清除本地模块缓存go clean -modcache
第二步：强制指定版本拉取go get github.com/gofiber/fiber/v2@v2.52.0（截至 2026 年 9 月最新稳定版）
第三步：验证是否成功
在空目录下新建 main.go，写入：
package main
import "github.com/gofiber/fiber/v2"
func main() { fiber.New() }
执行 go build，无报错即表示依赖已正确解析。
处理多版本共存冲突
若项目中同时引用 v1 和 v2，或间接依赖了不同 major 版本的 Fiber（如某中间件锁死 v1），会触发 version conflict 错误。
运行：go list -m all | grep fiber，查看实际加载的版本。
若输出含 v1.x.x，说明存在隐式依赖。此时需：
① 定位哪个依赖包 require 了 v1（查其 go.mod）；
② 升级该依赖至支持 v2 的版本；
③ 或用 replace 强制统一：go mod edit -replace github.com/gofiber/fiber/v1=github.com/gofiber/fiber/v2@v2.52.0
