fiber.Logger() 不适用于生产环境,因其默认输出到 os.Stdout,缺乏日志轮转、时间戳、级别区分和结构化支持,字段顺序硬编码且不可定制,禁用内置 logger 后调用会 panic。

fiber.Logger() 为什么不能直接用于生产环境
它默认写到 os.Stdout,不轮转、无时间戳、不区分日志级别、不支持结构化输出。线上查问题时,你没法快速定位请求 ID、来源 IP、真实耗时或错误堆栈——所有字段都挤在一行字符串里,且格式固定不可控。
-
fiber.Logger()只接受一个io.Writer和几个样式开关(如EnableColor),根本没有Format字段可配置 - 它内部硬编码了字段顺序和拼接逻辑:固定为
"time status method path latency bytes",加 trace_id 或删 query 参数都不可能 - 调用
fiber.New(fiber.Config{Logger: false})后,app.Use(fiber.Logger())会 panic:因为框架已禁用内置 logger,不能再注册它
如何手写中间件实现带 trace_id 和毫秒级耗时的日志
必须自己构造日志行,用 time.Now() 记起始时间,用 c.Locals 存 ID,确保 c.Response().StatusCode() 在 c.Next() 之后读取。
- 生成 ID 推荐用
uuid.New().String(),存入c.Locals("req_id"),再设响应头c.Set("X-Request-ID", id) - 耗时必须用
start := time.Now()+time.Since(start).Milliseconds(),别用time.Now().UnixMilli()——它和请求开始时间无关 - 路径建议用
c.OriginalURL()而非c.Path(),否则丢 query;但要注意 XSS 风险,敏感参数需脱敏 - 示例关键片段:
func LoggerPrint() fiber.Handler { return func(c *fiber.Ctx) error { start := time.Now() id := uuid.New().String() c.Locals("req_id", id) c.Set("X-Request-ID", id) err := c.Next() status := c.Response().StatusCode() duration := time.Since(start).Milliseconds() logLine := fmt.Sprintf("[%s] %s %s %d %.2fms\n", start.Format("2006-01-02 15:04:05"), strings.ToUpper(c.Method()), c.OriginalURL(), status, duration, ) fmt.Print(logLine) return err } }
如何安全地把日志同时写入文件和控制台
靠 io.MultiWriter 拼接多个 writer,但文件句柄必须全局复用,不能在中间件里反复 os.OpenFile() —— 否则 fd 泄漏、日志错乱、按天切分失效。
- 初始化日志文件应在
main()开头一次完成:file, _ := os.OpenFile("logs/app.log", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644) - 组合 writer:
writer := io.MultiWriter(os.Stdout, file),然后传给自定义中间件或结构化日志库的Output - 若需按天切分,别手动拼日期字符串再 open;改用
lumberjack.Logger,设置MaxAge: 7、Rotation: true,它自动归档、压缩、清理 - 注意权限:Linux 下文件模式用
0644,Windows 下部分版本忽略该参数,但写全更稳妥
为什么不要用标准 log 包输出 JSON 日志
log.Printf 输出的是纯字符串,无法被 ELK/Loki 正确解析字段;强行用正则提取 status 或 latency 效率低、易出错、丢失类型信息。
- 正确做法是跳过
log,直接用zerolog或zap构造结构化 event - 把
c.Method()、c.OriginalURL()、c.IP()、c.Get("User-Agent")、status、duration、id全部作为字段塞进zerolog.Event().Str().Int().Dur() - 最终输出是严格 JSON,字段名可控、类型明确、无解析歧义,也方便加
level字段做日志分级过滤 - 别在中间件里调
c.Status()或c.Send(),否则c.Response().StatusCode()可能返回 0 —— 真实状态码只在c.Next()返回后才确定
Fiber 的日志本质是「中间件触发 + 外部 writer 承载」,真正复杂的是 writer 的生命周期管理、trace_id 的透传一致性、以及结构化字段的完整性校验——这些点一旦漏掉,日志就退化成不可靠的装饰性输出。











