根本原因是import路径错误:v2须用"github.com/gofiber/fiber/v2",v3须用"/v3",省略版本号或混用会导致cannot find package;需确保go.mod中require与import路径版本严格一致。

Go 模块路径引用错误是 Fiber 安装后“找不到包”的根本原因,不是没装上,而是 import 路径写错了——v2 和 v3 的导入路径完全不同,混用必报 cannot find package。
检查 Go 版本与 Fiber 版本是否匹配
运行 go version 确认当前版本。Fiber v2 支持 Go 1.21+,v3 要求 Go 1.24+。若版本不匹配:
- Go go get github.com/gofiber/fiber/v2
- Go go install golang.org/dl/go1.24@latest && go1.24 download
- 已升级 Go 1.24+ 但还报错 → 检查
go.mod里是否残留 v2 路径
import 路径必须带 /v2 或 /v3 后缀
Fiber 不是 github.com/gofiber/fiber,省略版本号会默认拉取 v0/v1(已废弃),导致编译失败或行为异常。
- v2 正确写法:
import "github.com/gofiber/fiber/v2" - v3 正确写法:
import "github.com/gofiber/fiber/v3" - 错误写法(常见翻车点):
import "github.com/gofiber/fiber"或import "github.com/gofiber/fiber/v1" - 别在同一个项目里混用 v2 和 v3:它们的函数签名、配置结构体、中间件类型都不兼容
go.mod 中的 require 行必须与 import 一致
执行 go mod tidy 后,检查 go.mod 文件里的 require 行:
- 如果 import 是
v2,go.mod必须含:github.com/gofiber/fiber/v2 v2.50.0(版本号以实际为准) - 如果手动改过
go.mod但没运行go mod tidy,Go 工具链不会自动同步依赖 - 发现旧版残留(如
v1.x或无版本后缀)→ 删除整行,再go mod tidy - IDE 缓存可能导致误报:VS Code 用户可尝试
Ctrl+Shift+P → Go: Reset Cache and Reload Packages
vendor 目录缺失或未启用时的路径问题
启用 GO111MODULE=on(默认)且未 go mod vendor 时,依赖全靠 go.sum 和远程模块代理。但某些 CI/CD 或离线环境会失败:
- 确认
go env GOPROXY是否为有效地址(如https://proxy.golang.org,direct) - 若需锁定依赖,执行:
go mod vendor,然后确保代码中所有import仍指向/v2或/v3 -
vendor/下的路径必须严格对应 import:比如vendor/github.com/gofiber/fiber/v2存在,才代表 v2 包真正可用 - 别把
vendor/放进gitignore后又忘了在构建机上go mod vendor—— 那就真找不到包了
最常被忽略的是:go.mod 里 require 的版本号和 import 路径的版本后缀必须咬死一致;哪怕只差一个 v 字符,Go 就当它是另一个包。











