Go slog.Handler.WithGroup 如何避免日志字段冲突：分组语义与动态属性

订单服务和库存服务都写了 id、status，日志平台收到的字段很快变得难以判断来源。Go 的 log/slog 可以让每个子系统拿到自己的 Logger：用 Handler.WithGroup 给属性加上命名空间，公共字段不必改名，也不会和别的模块撞在一起。

把稳定的公共属性放在 Logger.With 中，把子系统边界放在 Logger.WithGroup 中；TextHandler 会展示为带点号的键，JSONHandler 会展示为嵌套对象。

先把公共字段和模块字段分开

Logger.With 适合请求级公共属性，例如 request_id；WithGroup 适合子系统边界，例如 order。两个方法可以连续使用，返回的 Logger 仍然共享原来的 Handler。

package main

import (
    "context"
    "os"
    "log/slog"
)

func main() {
    handler := slog.NewJSONHandler(os.Stdout, nil)
    base := slog.New(handler).With("request_id", "r-2048")
    orderLogger := base.WithGroup("order")

    orderLogger.LogAttrs(context.Background(), slog.LevelInfo, "paid",
        slog.String("id", "o-17"),
        slog.String("status", "confirmed"),
    )
}

这里的调用链是 base → WithGroup("order") → LogAttrs。request_id 仍是公共字段，id 和 status 则属于 order 组。用 LogAttrs 可以把已经构造好的 Attr 直接交给 Logger，字段边界更容易在代码评审中检查。

TextHandler 与 JSONHandler 怎样呈现同一个分组

分组的语义由 Handler 负责呈现。把 Handler 换成 slog.NewTextHandler，你会看到扁平的点号键；换成 slog.NewJSONHandler，组名会成为对象键。不要根据展示形式判断是否发生了字段复制，先看 Handler 的输出契约。

func newLogger(w io.Writer, jsonOutput bool) *slog.Logger {
    if jsonOutput {
        return slog.New(slog.NewJSONHandler(w, nil)).WithGroup("order")
    }
    return slog.New(slog.NewTextHandler(w, nil)).WithGroup("order")
}

logger := newLogger(os.Stdout, true)
logger.Info("paid", "id", "o-17", "status", "confirmed")

JSON 输出的关键片段类似 "order":{"id":"o-17","status":"confirmed"}；Text 输出则类似 order.id=o-17 order.status=confirmed。两者都保留了 order 这个稳定路径，日志检索规则可以围绕路径写，而不是绑定某一种输出格式。

动态属性、嵌套组和空组名的边界

动态属性不会自动变成分组字段

组只负责限定名字，真正的字段仍由调用点传入。请求处理过程中才知道的 warehouse、retry 等属性，应在 LogAttrs 调用处明确写出。这样可以避免一个隐藏的 LogValuer 把不该出现的字段带进日志。

嵌套组表达模块层级

base.WithGroup("order").WithGroup("payment") 会形成 order.payment 的路径；JSONHandler 则形成两层对象。层级超过两三层后，查询条件会变长，建议回到更稳定的领域边界。

空组名不是“取消分组”

不要用动态字符串随意生成组名。组名来自配置或外部输入时，先做白名单或固定映射，避免同一个字段因为拼写变化产生多条检索路径。确实需要无组字段时，直接使用未调用 WithGroup 的 Logger 更清楚。

相关问题

WithGroup 会创建一个全新的 Handler 吗？

不会。它返回新的 Logger，底层仍关联原 Handler；变化是后续属性带上了组路径。

同一个 Logger 可以给多个子系统使用吗？

可以，但更建议分别派生 WithGroup("order") 和 WithGroup("inventory")，让字段归属在调用点可见。

什么时候应该用 slog.Group？

一次日志调用本身就有一组局部属性时，用 slog.Group 更直接；需要给某个 Logger 的所有后续输出加命名空间时，用 WithGroup。

落地检查清单

• 请求级属性是否通过 With 固定，而不是每次重复拼接。
• 子系统是否使用稳定、有限的组名。
• TextHandler 和 JSONHandler 的检索规则是否分别验证过。
• 动态属性是否在 LogAttrs 调用处显式出现。

分组的价值不在于让日志更“漂亮”，而在于让字段路径稳定。先定义模块边界，再决定是使用一层组还是局部 slog.Group，后续更换输出 Handler 时，查询和排障成本会低很多。