app.Test() 是验证 Fiber 安装是否成功的最小可运行方法，它在内存中模拟完整请求生命周期，能直接暴露 import 路径错误、版本冲突或 Go 版本不匹配等真问题，而 curl 或 http.Get 仅测试网络连通性。
直接跑一个最小可运行的 app.Test() 就能验证安装是否成功，不用启动服务器、也不用开浏览器——它在内存里走完整个请求生命周期，快且干净。
为什么不能用 http.Get 或 curl 测试安装？
因为那测的是「网络连通性」和「端口监听」，不是 Fiber 本身是否可用。你可能装对了 Fiber，但忘了 go mod tidy，或本地有旧版缓存，curl http://localhost:3000 成功了，其实跑的还是上一个编译产物；反过来，app.Test() 一调就 panic，说明 import 路径错、版本冲突或 Go 版本不匹配，这才是真问题。
-
fiber.New()后没注册路由 →app.Test(req)返回 404，不是安装失败，是逻辑缺失 - import 路径写成
github.com/gofiber/fiber（缺/v2）→ 编译报错cannot find package - Go 版本低于 1.24 却装 v3 →
go get静默拉取旧版，fiber.NewWithCustomCtx找不到
app.Test() 最小验证代码怎么写？
新建 main_test.go，内容只保留三件事：创建 app、注册一个 GET 路由、构造请求并调用 Test()。别加中间件、别解析 JSON、别连数据库。
package main
import (
"net/http"
"testing"
"github.com/gofiber/fiber/v2"
)
func TestFiberInstall(t *testing.T) {
app := fiber.New()
app.Get("/ping", func(c *fiber.Ctx) error {
return c.SendString("ok")
})
req, _ := http.NewRequest("GET", "/ping", nil)
resp, err := app.Test(req)
if err != nil {
t.Fatal(err)
}
if resp.StatusCode != 200 {
t.Errorf("expected 200, got %d", resp.StatusCode)
}
}
- 必须显式调用
app.Get()，否则app.Test()一定 404 -
http.NewRequest的 URL 路径要带/前缀（如"/ping"），不能写"ping" - 别设
msTimeout参数——默认 1 秒足够，超时只会掩盖真实错误
测试失败时优先看这三行错误
终端输出里盯紧这三类信息，它们直接对应安装链路上最关键的断点：
-
undefined: fiber.New→ import 路径错，确认是github.com/gofiber/fiber/v2（非/v3或无版本） -
cannot find module providing package github.com/gofiber/fiber/v2→go mod tidy没执行，或 GOPROXY 不可用 -
panic: runtime error: invalid memory address→ Go 版本太低（v2 要求 ≥1.21，v3 要求 ≥1.24），用go version确认
真正容易被忽略的是：Fiber 安装成功 ≠ 项目能跑，它极度依赖 go.mod 里版本锁定和 go.sum 校验。哪怕只改了一行 go get 命令，也建议立刻 go mod vendor 看是否报 checksum mismatch。
