推荐使用 go get github.com/gofiber/fiber/v2,因v3仍处测试阶段、文档不全、生态未对齐、强制要求Go 1.24+,且v2/v3混用会导致构建失败或panic;生产环境应避免使用v3。

直接用 go get github.com/gofiber/fiber/v2,这是当前(2026年10月)唯一推荐的稳定版安装方式。
为什么不是 v3?
v3 仍处于测试阶段,文档不全、生态工具未对齐,且强制要求 Go 1.24+。生产环境混用 v2/v3 import 路径会导致构建失败或运行时 panic。除非你明确在做 v3 兼容性验证,否则别碰 go get github.com/gofiber/fiber/v3。
安装前必须检查 Go 版本
运行 go version 确认版本 ≥ 1.21。若低于该值:
• 不要跳过升级——go get 可能静默拉取旧版兼容分支,导致后续行为异常
• 推荐用 go install golang.org/dl/go1.21@latest 下载并执行 go1.21 download
初始化项目别用 fiber.Default()
它默认加载 Logger、Recover、RequestID 等中间件,I/O 开销大,TTFB 增加 0.3–0.8ms。
• 正确写法是 app := fiber.New()
• 中间件按需添加:debug 环境才加 logger.New(),生产环境 recover 配置里关掉堆栈:recover.New(recover.Config{EnableStackTrace: false})
第一个路由 404?大概率是 StrictRouting 导致的
Fiber 默认 StrictRouting: true,/users 和 /users/ 是两条不同路由。
• 别全局关掉它——否则 /users/:id 会被 /users 错误匹配
• 推荐加个重定向中间件:if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) }
• 或显式注册两个路径:app.Get("/users", h) 和 app.Get("/users/", h)
StrictRouting 和中间件加载顺序是上线前最容易忽略的两个点,它们不会报错,但会悄悄拖慢性能或让前端请求反复 404。











