Go Zerolog 怎样为子日志器绑定固定业务字段

Go Zerolog 为子日志器绑定固定业务字段，核心就是先创建一个根 Logger，再通过 With().Str(...).Logger() 派生组件级日志器。这样每次事件都会自动带上 service、component 等稳定字段；request_id、job_id 这类随请求变化的值则应留在更窄的日志器或当前事件中。

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

固定字段属于“这个日志器代表谁”，动态字段属于“这一次发生了什么”。先按生命周期拆开，再用 Logger.With() 创建子日志器，就能避免共享 Logger 被请求字段污染。

• 资产边界：service、component 是适合长期复用的业务身份字段。
• 绑定写法：With 返回字段构造上下文，Str 写入字符串字段，Logger 生成子日志器。
• 风险控制：请求级字段不要回写共享 Logger，也不要把 Token、密码等敏感值放进固定上下文。

先划分固定字段和动态字段

固定业务字段的判断标准不是“看起来重要”，而是它在一个日志器的整个使用范围内是否稳定。服务名、组件名、部署分区通常可以绑定在组件子日志器上；请求 ID、用户 ID、任务 ID 则随着调用变化，应该在请求边界重新派生，或者只附加到当前事件。

这个划分也是日志审计的第一道边界：如果把动态字段写进共享 Logger，后续并发请求可能看到不属于自己的上下文；如果把秘密配置绑定进 Logger，字段会跟着大量事件扩散。

用 With 和 Logger 创建子日志器

Zerolog 的官方示例使用 log.With().Str("component", "foo").Logger() 创建子日志器。工程代码可以显式创建根 Logger，再让组件只接收自己的子 Logger，避免业务包隐式依赖全局日志器。

package main

import (
	"os"

	"github.com/rs/zerolog"
)

func main() {
	// 根 Logger 只负责输出目标和稳定的服务身份。
	root := zerolog.New(os.Stdout).With().
		Str("service", "billing").
		Logger()

	// 子日志器固定代表 reconcile 组件，后续事件自动继承两个字段。
	reconcileLog := root.With().
		Str("component", "reconcile").
		Logger()

	// 事件字段只描述本次任务，不改变共享的组件日志器。
	reconcileLog.Info().
		Str("job_id", "job-42").
		Msg("开始处理对账任务")
}

这里的链式调用分成三层：zerolog.New 建立根 Logger，With 取得字段上下文，Str 添加字段，最后的 Logger 把上下文变成可注入的子 Logger。每次调用 Info 创建事件时，service 和 component 都会随 JSON 日志输出。

把请求字段放到更窄的范围

组件日志器可以长期复用，但请求字段不能无期限跟随它。常见做法是在一次请求或任务开始时，从组件 Logger 再派生一个请求子日志器；如果只需要写一条日志，也可以直接在 Event 上追加字段。

func handle(reconcileLog zerolog.Logger, requestID string) {
	// 请求子日志器只在本次调用范围内携带 request_id。
	requestLog := reconcileLog.With().
		Str("request_id", requestID).
		Logger()

	// 动态字段与固定字段一起写出，但不会修改 reconcileLog。
	requestLog.Info().Msg("开始处理请求")

	// 一次性字段也可以直接放在事件上，避免扩大生命周期。
	requestLog.Warn().
		Str("decision", "defer").
		Msg("请求被延后处理")
}

组件级字段和请求级字段在这里形成两个清晰的域：前者回答“哪个服务、哪个组件”，后者回答“哪一次请求”。不要为了省一行代码调用共享 Logger 的 UpdateContext 去写入请求字段；维护边界时，应让动态值跟着局部变量、请求子 Logger 或单个 Event 走。

复查重复键和敏感字段

子日志器并不替代字段治理。接入前可以按下面的清单检查：第一，固定字段名称是否由团队统一，例如不要同时使用 component 和 module 表示同一个概念；第二，事件上是否重复写入同名键，避免读日志的人无法判断哪个值代表真实语义；第三，字段值是否可能包含密码、访问令牌、完整身份证件或不必要的个人数据。

如果必须记录错误，优先写可定位但不泄露秘密的错误标识；如果需要跨函数传递日志器，可以显式把子 Logger 作为参数，或使用 Zerolog 提供的 WithContext 与 Ctx 组合，但仍要保证上下文的生命周期不超过请求本身。

Go Zerolog 子日志器常见问题

固定字段应该放在 Event 还是 Logger 上？

跨多个事件都稳定的服务名、组件名适合放在子 Logger 上；只出现一次或每次不同的值适合放在 Event 上。按生命周期选择位置，比单纯追求链式调用更重要。

为什么不直接修改全局 Logger？

全局 Logger 适合确实全局稳定的字段。请求、任务或租户字段具有局部生命周期，直接修改共享对象会让并发代码难以判断字段来源，因此应创建更窄的子 Logger。

子日志器会自动生成 request_id 吗？

不会。Zerolog 只负责把你通过 Str 等方法绑定的字段写入事件；请求 ID 的生成、传递和脱敏仍由应用自己的请求链路负责。

最终可以把规则压缩成一句话：用根 Logger 固定服务身份，用组件子 Logger 固定业务模块，用请求子 Logger 或 Event 承载动态上下文，并在边界处复查重复键和敏感数据。