生产环境必须用fiber.New()而非fiber.Default(),因后者自带logger和recover中间件,导致敏感头泄露、TTFB增加0.3–0.8ms;StrictRouting默认开启使/users与/users/视为不同路径而404,推荐重定向中间件而非关闭。

直接用 fiber.New() 启动微服务,别碰 fiber.Default()——后者自带日志和恢复中间件,上线等于把 Authorization、Cookie 全打到日志里,还多 0.3–0.8ms 延迟。
为什么 fiber.Default() 不适合微服务上线
fiber.Default() 是开发快捷方式,它内部自动调用了 app.Use(logger, recover)。微服务部署在 Kubernetes 或 Service Mesh 环境中时,这些中间件会:
- 把完整请求头(含敏感字段)写进 stdout,和结构化日志混在一起,难过滤也违反安全规范
- recover 中间件捕获 panic 后仍返回 500,掩盖真实错误上下文,不利于链路追踪定位
- Logger 每次写入都触发一次系统调用,在高 QPS 下成为瓶颈,实测 TTFB 增加 0.3–0.8ms
生产微服务应始终从 fiber.New() 开始,按需添加中间件,比如只对 4xx/5xx 记录错误日志,或对接 OpenTelemetry。
StrictRouting 导致 /users 和 /users/ 404 怎么办
Fiber 默认开启 StrictRouting: true,这是路由匹配的底层行为,不是 bug。现象是:你只注册了 app.Get("/users", handler),但前端发来 /users/(带尾斜杠),结果 404。原因很直接:Fiber 把这两个路径当完全不同的字符串处理。
不推荐关 StrictRouting:fiber.New(&fiber.Config{StrictRouting: false}),因为关闭后 /users/123 可能被 /users 错误匹配,c.Params("id") 拿不到值。
更稳的做法是加统一重定向中间件:
app.Use(func(c *fiber.Ctx) error {
if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" {
return c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301)
}
return c.Next()
})
或者显式注册两条路由:app.Get("/users", handler) 和 app.Get("/users/", redirectHandler)。
Query、Params、Body 三者取值来源必须分清
混淆这三者是 Fiber 新手最常踩的坑,表现就是参数总为空,但查半天没报错。
-
c.QueryParam("q")只读 URL query string,例如/search?q=go&page=2中的q -
c.Params("id")只读路由占位符,例如app.Get("/user/:id", ...)匹配/user/123后的"123" -
c.FormValue("name")专用于application/x-www-form-urlencoded;JSON body 必须用c.Body()+json.Unmarshal,或更安全的c.Struct(&v)
典型错误示例:curl -X POST -H "Content-Type: application/json" -d '{"name":"foo"}' /api/user,却用 c.FormValue("name") 去取——必然为空。
ctx.Next() 为什么不执行下一个 handler
c.Next() 不是“继续往下走”,而是把控制权交还给 Fiber 调度器。它是否继续执行后续 handler,取决于当前 handler 是否已写入响应。
常见误用场景是权限中间件:
app.Use(func(c *fiber.Ctx) error {
if !isValidToken(c.Get("Authorization")) {
return c.Status(401).SendString("unauthorized") // ✅ 已写响应,Next() 不再执行
}
return c.Next() // ✅ 此时才放行
})
如果漏掉 return,或写了 c.Status(401) 但没调 SendString 等写入方法,Fiber 会认为响应未完成,继续往后走,导致鉴权失效或重复写响应 panic。
微服务里最易被忽略的是中间件顺序和 ctx 实例复用:同一个 *fiber.Ctx 在整个请求生命周期内被所有中间件共享,任何中间件修改了 c.Locals 或 c.Context().Value,后续 handler 都会看到。别在中间件里覆盖关键键名,比如用 c.Locals["user"] = user 没问题,但用 c.Locals["id"] 就容易和路由参数冲突。











