Fiber 与 Gin 不可直接互换，需重构中间件、路由、上下文、优雅关闭等核心逻辑：必须用 fiber.New() 替代 fiber.Default()，严格处理 StrictRouting、Locals 复用污染及信号生命周期对齐。
不能直接把 Gin 项目代码套进 Fiber，也不能指望用同一套中间件或生命周期管理逻辑——Fiber 和 Gin 是两条技术路径，底层 HTTP 处理、上下文模型、信号响应机制完全不同。强行混用只会让上线前夜变成 debug 现场。
fiber.New() 替换 gin.Default() 不是改个函数名的事
Gin 的 gin.Default() 自动挂载 Logger、Recovery、CORS（若引入）等中间件；Fiber 的 fiber.Default() 同样默认启用 Logger、Recover、RequestID，但行为更激进：Logger 会明文打印 Authorization 头，Recover 默认开启堆栈，且两者都不可通过配置一键关闭。
- 必须全部删掉
fiber.Default()，改用fiber.New()初始化空实例 - 开发阶段如需日志，只加
logger.New(logger.Config{Format: "${status} - ${method} ${path}"})，禁用Header和Body输出 - 生产环境 Recovery 中间件必须设
EnableStackTrace: false，否则 panic 日志含敏感变量 -
fiber.Config{DisableStartupMessage: true}必加，避免干扰kubectl logs -f或日志采集器
StrictRouting 导致的 404 和 Gin 的路由宽容性不兼容
Gin 默认接受 /users 和 /users/（尾部斜杠自动归一），Fiber v2/v3 默认 StrictRouting: true，二者视为完全不同的路由。你在 Gin 里注册 r.GET("/users", h)，迁到 Fiber 后访问 /users/ 就是 404，不是 bug，是配置对齐缺失。
- 别全局设
StrictRouting: false——它会让/users和/users/:id冲突，c.Params("id")拿不到值 - 推荐加一个轻量重定向中间件：
if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) } - 调试期可临时显式注册两条路由，但上线前必须清理，避免冗余匹配开销
ctx 生命周期和 Locals 使用方式彻底不同
Gin 的 *gin.Context 每次请求新建；Fiber 的 *fiber.Ctx 是对象池复用——这意味着你在 handler 里调用 c.Locals("user", u) 存了结构体指针，下个请求进来可能直接读到上一个请求残留的 u 地址，造成数据污染。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 所有
c.Locals()存的值，必须是值类型（int,string,struct{}）或显式拷贝后的指针（用utils.CopyString()或copy()） - 不要在中间件里存全局状态（比如 auth token 解析结果），应在 handler 开头解析并传参，或用
c.Context().Value()（标准 context）替代 - v3 中
fiber.Ctx是接口而非指针，别写func(c *fiber.Ctx)，签名必须是func(c fiber.Ctx) error
优雅关闭和 K8s 生命周期对齐要重写，不能抄 Gin 示例
Gin 常见的 r.Run() 是阻塞式，靠 http.ListenAndServe 内部处理信号；Fiber 的 app.Listen() 同样不监听 SIGTERM，滚动更新时 Pod 被强杀，连接中断不可避免。
- 必须弃用
app.Listen()，改用标准http.Server包裹：srv := &http.Server{Addr: ":8080", Handler: app} - 启动后起 goroutine 调
srv.ListenAndServe()，主 goroutine 监听os.Signal -
srv.Shutdown()前建议先关闭 readiness probe 端点（返回 503），再等待活跃连接 draining - 务必设
ReadTimeout和WriteTimeout，否则长轮询或大文件上传会卡住 shutdown 流程
最易被忽略的是：Fiber 的 *fiber.Ctx 复用机制不会自动清空 Locals、Values、QueryParams 缓冲区，迁移时只要有一处没手动重置，线上就会出现跨请求数据泄露——这问题在压测环境几乎不暴露，上线后才突然爆发。
