Fiber 不兼容 net/http 生态，因其 app 未实现 http.Handler 接口，底层基于 fasthttp，需用 app.Handler() 单向桥接，但会丢失 Fiber 原生能力；强行混用将导致中间件失效、路由 404、SSE 断连等事故。
Fiber 不兼容 net/http 生态，强行套用会直接导致中间件失效、路由 404、SSE 断连等线上事故。 它不是“配一下就能用”的问题，而是底层请求上下文（fiber.Ctx）和标准 http.Handler 类型不互通——gqlgen、go-swagger、promhttp 这类依赖 http.Handler 接口的库，无法直接注入 Fiber 应用。
为什么 fiber.New() 返回的 app 不能当 http.Handler 用
Fiber v2/v3 的 app 实例没有实现 http.Handler 接口；它内部用的是自研的 fasthttp 封装层，fiber.Ctx 是对 fasthttp.RequestCtx 的包装，而非 *http.Request + http.ResponseWriter。这意味着：
- 你不能把
app直接传给http.ListenAndServe(":8080", app)—— 编译报错：cannot use app (type *fiber.App) as type http.Handler - 所有基于
http.Handler构建的中间件（如promhttp.Handler()、http.StripPrefix）无法链式接入 -
http.DefaultServeMux和 Fiber 路由完全隔离，混用会导致路由静默失效（比如注册了/health到 DefaultServeMux，但 Fiber 的/api/*拦截了全部请求）
想复用 net/http 生态？只能走 Adapter 模式
唯一安全路径是用 fiber.New().Handler 方法将 Fiber 转为 http.Handler，但注意：这是单向桥接，且有严格限制：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须用
app.Handler()（返回http.Handler），不能用app.ServeHTTP（那是内部方法，签名不匹配） - 转换后丢失所有 Fiber 原生能力：无法再调用
c.Next()、c.Locals、c.Params等，仅保留基础响应逻辑 - 转换后的 handler 无法再注册 Fiber 中间件（如
jwt.New()），只能挂载纯http.Handler类型中间件 - 示例写法：
app := fiber.New()
app.Get("/api/users", func(c fiber.Ctx) error {
return c.JSON(map[string]string{"data": "ok"})
})
// ✅ 正确：转成标准 http.Handler
http.ListenAndServe(":8080", app.Handler())
// ❌ 错误：类型不匹配
// http.ListenAndServe(":8080", app)
// ❌ 错误：无法再加 Fiber 中间件
// app.Use(jwt.New()) // 此时已无意义
Fiber v3 的 Handler 签名变更让兼容更难
v3 把 func(fiber.Ctx) error 作为唯一路由处理器签名，而 v2 兼容部分 func(*fiber.Ctx) 形式。这导致：
- v2 的中间件（如
cors.New()、rateLimiter.New()）无法在 v3 中直接使用——函数签名不匹配，编译失败 - 即使你手动包装
http.Handler成 Fiber handler，也要自己处理context.Context透传、超时、取消信号，否则net/http的Request.Context().Done()无法触发 Fiber 请求终止 - v3 默认启用内存复用，若你桥接到
http.Handler后又试图读取原始 body（如解析 JSON），可能拿到已被复用的脏内存，需显式调用c.Request().Body()并拷贝
真正需要 net/http 生态时，别硬套 Fiber——选 gorilla/mux 或 chi，它们原生兼容 http.Handler，支持子路由、中间件链、正则参数，且性能足够生产使用。Fiber 的价值在于 fasthttp 底层带来的吞吐优势，而不是“换个壳继续用 net/http 那套”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
