Fiber环境验证成功标准是：go run main.go不报import错误且浏览器访问localhost:3000返回“Hello, World!”；需确保已执行go get github.com/gofiber/fiber/v2、go mod tidy无误、路由注册正确（如用fiber.New()而非fiber.Default()）、StrictRouting导致的404需显式处理。
运行 go run 能打出 Hello World 就算成功
别纠结“安装成功”的抽象定义——Fiber 是纯 Go 包，没有全局 CLI 或系统级注册。只要 go run main.go 不报 import "github.com/gofiber/fiber/v2" 相关错误，且浏览器能访问 http://localhost:3000/ 返回 “Hello, World!”，就说明环境、依赖、编译、运行全链路通了。
常见卡点：
-
go: cannot find module providing package github.com/gofiber/fiber/v2：没执行go get github.com/gofiber/fiber/v2，或当前目录不在 module 根下（检查是否有go.mod） - 启动后浏览器空白或连接被拒绝：端口被占（换
:3001）、程序 panic 退出（看终端是否闪退）、防火墙拦截（本地开发通常不是） - 返回 404：路由注册写错，比如写了
app.Get("/hello", ...)却访问/；或用了fiber.Default()但没意识到它默认禁用/路由（v2 中fiber.Default()不注册根路径）
go mod tidy 后无报错才是依赖真正就位
Fiber v2 要求 Go ≥ 1.21+，go get 只是下载，不校验兼容性。真正验证依赖是否干净，得靠 go mod tidy：
- 运行
go mod tidy后，终端没输出任何 error 或 require 行变动，且生成/更新了go.sum，说明版本解析成功 - 如果提示
require github.com/gofiber/fiber/v2: version "v2.x.y" invalid：Go 版本太低，升级到 1.21+ 再试 - 如果
go.mod里出现v3或master分支：手动改回github.com/gofiber/fiber/v2 v2.52.0（查最新 v2 tag），再tidy
用 app.Test() 验证路由逻辑不依赖真实网络
启动 HTTP 服务只是粗粒度验证；真要确认 handler 逻辑跑对了，得用框架内置的测试方法。这是唯一推荐的单元测试入口，绕过 TCP 层，快且隔离：
- 必须先注册路由再调
app.Test()，否则一律 404 —— Fiber 不反射扫描，app.Get("/ping", ...)这行代码必须执行到 - 构造请求用
http.NewRequest("GET", "/ping", nil)，传给app.Test(req)，检查resp.StatusCode == 200 - 别漏设
req.Header.Set("Content-Type", "application/json")—— POST/PUT 测试时，c.BodyParser()会因 header 缺失静默失败 - 测试函数末尾加
t.Cleanup(func() { app.Shutdown() })，避免 goroutine 泄漏（尤其用了数据库/Redis client 时）
首个应用里最该立刻删掉的两行代码
新手照抄示例容易埋坑，这两个点上线前必改：
-
app := fiber.Default()：它默认加载logger和recover中间件，每秒几百次日志 I/O 会吃掉 30%+ QPS；换成app := fiber.New()，按需加中间件 -
log.Fatal(app.Listen(":3000"))：生产环境不能裸用log.Fatal，应捕获 error 并优雅处理，比如if err := app.Listen(":3000"); err != nil { log.Fatal(err) }
StrictRouting 默认开启，/users 和 /users/ 是两个路由。别关它，显式注册或加重定向中间件更安全。
