fiber.Logger不是插件,仅是内置中间件,生产环境禁用;应手写结构化日志中间件,复用全局zap.Logger,禁用Development配置,避免内存分配与敏感信息泄露。

fiber.Logger 不是插件,不能“同步安装”——它只是 Fiber 内置的一个中间件函数,调用 app.Use(fiber.Logger()) 就能启用,但**生产环境不该直接用它**。
真正要配的,是结构化、可扩展、不拖慢性能的日志能力。下面分三块说清楚怎么做、为什么、容易错哪。
fiber.Logger() 为什么不能直接当访问日志用
它只输出三字段:time + status + latency,连 c.IP()、c.Method()、c.Path() 都没有。你看到的“日志”,其实只是调试快照,不是 Nginx 那种可采集、可过滤、带上下文的访问日志。
更关键的是:它硬编码了格式,没法加 trace_id,没法脱敏 Authorization 或查询参数,也没法对接 ELK / Loki。强行塞进生产,等于把敏感数据打到 stdout 里裸奔。
结构化日志必须自己写中间件,别依赖第三方“Fiber 日志插件”
市面上所谓 “Fiber 日志插件” 多数只是封装了 log.Printf 或简单 zerolog 调用,没处理好三个致命点:
- 没在
c.Next()后读取c.Response().StatusCode()和耗时 → 状态码永远是 200 - 每次请求都调
logger.With(...)→ 高频下触发大量内存分配(实测 QPS 下降 15%+) - 直接用
c.Get("User-Agent")或c.Query("token")→ 敏感字段原样输出,审计过不了
正确做法是手写一个轻量中间件,复用全局 logger 实例:
app.Use(func(c *fiber.Ctx) error {
start := time.Now()
err := c.Next()
status := c.Response().StatusCode()
duration := time.Since(start).Milliseconds()
// 预定义字段,避免 With() 动态拼接
fields := []zap.Field{
zap.String("ip", c.IP()),
zap.String("method", c.Method()),
zap.String("path", c.Path()),
zap.Int("status", status),
zap.Float64("duration_ms", duration),
}
if ua := c.Get("User-Agent"); ua != "" {
fields = append(fields, zap.String("user_agent", ua))
}
app.logger.Info("http_request", fields...)
return err
})
zap.NewProduction() 是唯一安全起点,别碰 Development 配置
哪怕只在某个 debug 接口里调一次 logger.Debug(),整个 *zap.Logger 实例就会退化为低性能路径——颜色、行号、堆栈、缩进 JSON 全开,日志体积膨胀 3 倍,ELK 解析失败率飙升。
生产初始化必须从 zap.NewProduction() 出发,并显式关闭风险项:
-
config.Sampling = nil—— 关闭采样,否则高频 trace 日志会被静默丢弃 -
config.EncoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder—— 避免time.Now().Format()分配 -
zapcore.Lock(zapcore.AddSync(file))—— 裸写文件句柄在多 goroutine 下会 panic
别用 ctx.Locals["logger"] = logger.With(...) 传实例 —— Locals 是临时存储,无类型安全,易被覆盖;应把 *zap.Logger 作为字段注入 App struct,handler 通过闭包或强类型 context key 获取。


















