上线前必须将fiber.Default()替换为fiber.New()，否则默认中间件会导致Authorization头泄露、磁盘I/O过载、TTFB增加0.3–0.8ms；StrictRouting为true时/users与/users/视为不同路由，需显式注册或重定向处理。
上线前不手动检查 fiber.Default() 和 StrictRouting，服务一上就出性能抖动或 404，不是 bug 是配置债。
fiber.Default() 必须替换成 fiber.New()
fiber.Default() 在生产环境会默认挂载 Logger、Recover、RequestID 三个中间件。每秒几百次请求就把 Authorization 头连同完整请求日志写满磁盘 I/O，实测 TTFB 增加 0.3–0.8ms；高并发下 recover 中间件还会频繁触发堆栈捕获，拖慢错误路径。
- 开发阶段可临时用
fiber.Default()快速验证逻辑，但上线前必须全局替换为fiber.New() - 只在 debug 环境加
logger.New()，且建议采样（如仅记录 5xx） - recover 中间件务必关掉堆栈：
recover.New(recover.Config{EnableStackTrace: false}) - RequestID 若真需要，用轻量版
requestid.New(requestid.Config{Generator: func() string { return uuid.NewString() }})，避免默认时间戳+随机数组合的同步锁开销
StrictRouting 导致的尾斜杠 404 必须显式处理
Fiber 默认 StrictRouting: true，/users 和 /users/ 是两条完全独立路由。只注册了前者，访问后者必然 404——这不是代码写错，是路径匹配规则生效。
- 别全局设
fiber.New(&fiber.Config{StrictRouting: false})：当同时存在/users和/users/:id时，/users/123可能被前者匹配，c.Params("id")拿不到值 - 推荐方案：加一层重定向中间件，把
/xxx/301 跳转到/xxx（注意保留 query） - 若 API 设计已约定带尾斜杠（如 RESTful collection），则显式注册两个版本：
app.Get("/users", handler)和app.Get("/users/", handler)
健康探针端点必须绕过所有中间件
K8s liveness probe 调用 /healthz 时，如果走 logger 或 recover，每次都会写日志、捕获 panic、生成 RequestID，响应极易超 1 秒导致 CrashLoopBackOff。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
app.Get("/healthz", healthzHandler)必须放在所有app.Use(...)之前，确保裸路由 - handler 内只做内存态检查：
atomic.LoadInt64(&healthy)+runtime.NumGoroutine()，不调time.Now()、不 new UUID、不查 DB - 响应用
c.Status(200).SendString("ok")，禁用c.JSON()（JSON 编码可能 panic）和c.SendStatus()（无 body，某些 LB 拒绝） - readyz 可查 DB，但必须带 context 超时：
ctx, cancel := context.WithTimeout(c.Context(), 1*time.Second)，并用db.PingContext(ctx)或连接池统计代替 SQL 查询
Go 版本与模块状态必须双校验
go version 显示 1.22 不代表 go.mod 允许它；go.mod 写着 go 1.24 也不代表本地装了 1.24——两者不一致时，go get github.com/gofiber/fiber/v2 表面成功，实际拉的是降级兼容版，后续调 fiber.New() 可能 panic。
- 运行
go version和grep "^go " go.mod，两者主次版本号必须都 ≥1.21（v2）或 ≥1.24（v3） - 执行
go list -m github.com/gofiber/fiber/v2，输出必须含v2.x.y，不能是v1.14.7或无/v2后缀 - 确认
GO111MODULE=on（go env GO111MODULE输出 must beon），否则模块系统不生效 -
go mod tidy后终端无 error、go.sum更新、且go.mod中require行稳定，才算依赖真正就位
最容易被忽略的是：fiber.New() 初始化后没加任何中间件，不代表服务“干净”——只要曾经用过 fiber.Default()，它的中间件注册逻辑可能还残留在测试代码、CI 脚本或旧分支里，上线前得 grep 全项目确认没有漏网之鱼。
