Go Zerolog 创建 Event 后没有调用 Msg 为什么不输出

我们在用 Zerolog 开发的时候经常会碰到一种情况：调用 Info()、Debug() 这类方法拿到了 Event 实例，后续又加了字段，但是忘了收尾调用 Msg 相关方法，最后整条日志啥都没打出来，很多刚上手的朋友都以为是哪里配置错了，其实这是 Zerolog 本身的设计特性。

Zerolog 不会在你调用创建 Event 的方法时自动触发输出，只有调用 Msg、Msgf、Send 这类专门用来提交日志的收尾方法，才会把当前 Event 里攒的所有字段序列化后写到输出流，跳过这步的 Event 会直接被框架标记为丢弃，不会产生任何输出。

Go Zerolog 出现“创建了 Event，但日志完全没有输出”时，第一检查点不是 JSON 格式，而是链尾有没有 Msg、Msgf 或 Send。Info()、Error()、Log() 返回的是一个待完成的 *zerolog.Event；字段方法只是在这个事件上继续添加数据，真正把事件交给 writer 的动作发生在终结方法中。

官方地址：https://github.com/rs/zerolog/

Event 为什么创建了却没有输出

Zerolog 的链式 API 把“准备事件”和“提交事件”拆开了。下面的写法只创建并填充了一个 Event，函数返回时没有任何一步要求它写入输出：

package main

import (
    "os"

    "github.com/rs/zerolog"
)

func main() {
    logger := zerolog.New(os.Stdout)

    // Info 返回待提交的 Event，Str 只负责追加字段。
    logger.Info().Str("request_id", "r-1001")
    // 这里没有 Msg、Msgf 或 Send，因此 Event 没有交给 writer。
}

这不是编译错误，因为表达式本身是合法的 Go 代码。对照 Zerolog 的实现，Event 会在 Msg、Msgf 或 Send 中完成写入；调用后对象还可能回收到内部池中，所以不能把它当作可长期保存的普通结构体。

按日志意图补上正确的终结方法

最常见的修复是把链条写完整。消息内容属于事件的一部分，但可以为空；“没有 message 字符串”和“没有提交事件”是两件事。

package main

import (
    "os"

    "github.com/rs/zerolog"
)

func main() {
    logger := zerolog.New(os.Stdout)

    // 有固定文本时用 Msg，调用结束后事件才会写出。
    logger.Info().Str("request_id", "r-1001").Msg("request accepted")

    // 需要格式化文本时用 Msgf；参数只在终结时组成 message。
    logger.Warn().Int("retry", 2).Msgf("retrying request %d", 2)

    // 只想输出字段时用 Send，等价于提交一个空 message 的事件。
    logger.Log().Str("phase", "flush").Send()
}

选择方法可以按下面的清单判断：

封装日志时最容易漏掉 Msg 的位置

问题经常出现在封装函数：函数先添加字段，遇到条件后提前返回，或者把 *zerolog.Event 当作返回值交给调用方，却没有约定谁负责终结。推荐让封装函数直接完成一次完整日志，减少悬空 Event：

func logCacheMiss(logger zerolog.Logger, key string, retry bool) {
    // 封装函数内部负责终结，调用方不需要猜测 Event 的所有权。
    event := logger.Warn().Str("cache_key", key)
    if retry {
        event.Bool("retry", true).Msg("cache miss; retry scheduled")
        return
    }
    // 非重试分支也必须提交，否则只添加字段不会产生日志。
    event.Bool("retry", false).Msg("cache miss")
}

如果业务必须由调用方决定消息，可以返回一个 Event，但要把约定写清楚，并保证每条路径只调用一次终结方法。不要在 Msg 之后再调用字段方法或再次 Msg；官方文档明确提示，终结后 Event 应被丢弃。

补上 Msg 后仍无输出的排查顺序

终结方法存在，只能证明事件尝试提交；如果依旧看不到内容，按以下顺序缩小范围：

1. 看等级：全局级别高于事件级别时，事件会被过滤。例如当前级别是 Error，Info 不会出现。
2. 看采样：使用 Sample 后，某些事件可能按采样策略被丢弃，排障时先临时移除采样器。
3. 看 Discard：Discard() 会把事件标记为禁用，即使后面调用 Msg 也不会输出。
4. 看 writer：默认日志可能写到 stderr；自定义 writer 或多路 writer 时，确认读取的是实际目标。

常见问题

只需要字段，不想写 message，必须调用 Msg 吗？

必须调用某个终结方法。可以用 Send()，也可以用 Msg("")；关键是让 Event 完成提交。

Msg 和 Send 有什么区别？

Msg 会在非空时增加 message 字段，Send 相当于用空消息提交事件。两者都不能重复调用。

为什么 Msg 已经存在，日志还是看不到？

优先检查全局日志等级、采样器、Discard 和 writer。终结方法解决的是“没有提交”的问题，不会绕过其他过滤条件。