Go slog.Handler.WithGroup 怎么避免属性组名冲突

slog.Handler.WithGroup 避免属性冲突的关键，不是给每个字段随意加前缀，而是把组名当成稳定的命名空间：先按业务域划分组，再在组内保持字段名唯一。比如请求日志使用 request，数据库日志使用 database，两边都可以有 status，但不能在同一组里重复写出两个含义不同的 status。

组名解决“字段属于哪一类”的问题，字段名解决“这一类里具体是什么”的问题。空组名不提供隔离，重复嵌套组名也不应被当成冲突治理方案。

先区分组路径与字段名

内置 Handler 会把组路径和字段名组合起来。文本输出通常表现为带前缀的键，JSON 输出则更接近嵌套对象；两者都遵守“后续属性属于当前组”的语义。因此，下面两条日志虽然字段名相同，但命名空间不同，读者可以分别检索。

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

requestLog := logger.WithGroup("request")
databaseLog := logger.WithGroup("database")

// 两个业务域可以拥有同名字段，但输出路径不同。
requestLog.Info("finished", slog.String("status", "ok"))
databaseLog.Info("finished", slog.String("status", "committed"))

组名建议使用稳定、短小、能表达边界的词，例如 request、user、database、upstream。不要把订单号或 URL 直接当组名；动态组会让索引字段爆炸，也会让相同事件难以聚合。

为业务域设计唯一组名

真实项目里，冲突常来自多个团队各自添加公共字段。可以先定义一张小型命名表，再把公共字段放到明确的层级：

字段名本身仍要具体。与其在根级别连续写 status、status，不如让它们分别出现在 request.status、database.status 和 upstream.status。如果一个字段确实是全局事件属性，例如 trace_id，就保持根级别一次写入，不要再复制到每个组。

处理嵌套组和空组

WithGroup("outer").WithGroup("inner") 表示组路径继续深入，后续属性属于两个组的组合范围。调用顺序也有意义：先加属性再进入新组，前面的属性不会凭空搬到新组中。要避免误判，测试时至少覆盖“根属性、一级组、二级组、同名字段、空组名”五种情况。

log := logger.WithGroup("request").With("trace_id", traceID)
log = log.WithGroup("database")

// trace_id 属于 request；query_name 属于 request.database。
log.Info("query", slog.String("query_name", "find_user"))

// 空组名不形成新的命名空间，不要拿它当作冲突修复。
same := log.WithGroup("")
same.Info("still-in-request-database")

如果组名来自外部输入，应先做白名单映射；日志组路径属于结构的一部分，不宜让用户输入直接改变字段层级。

自定义 Handler 时保留边界

实现自己的 Handler 时，最重要的约定是 WithGroup 和 WithAttrs 返回新 Handler，不修改原对象。这样同一个基础 logger 才能安全派生出请求、数据库和下游三条分支。

type groupedHandler struct {
    groups []string
    attrs  []slog.Attr
}

func (h *groupedHandler) WithGroup(name string) slog.Handler {
    // 空组名不改变命名空间，避免制造一个无意义的层级。
    if name == "" {
        return h
    }
    next := *h
    // 复制切片后追加，不能污染原 Handler 的组栈。
    next.groups = append(append([]string(nil), h.groups...), name)
    return &next
}

func (h *groupedHandler) WithAttrs(attrs []slog.Attr) slog.Handler {
    next := *h
    // 保留调用顺序，Handle 再按组栈组合最终键。
    next.attrs = append(append([]slog.Attr(nil), h.attrs...), attrs...)
    return &next
}

自定义 Handler 还要决定重复路径怎么处理：可以拒绝同一组内的重复键，可以保留后写值，也可以把重复值变成数组，但必须写进接口契约并测试。不要让“最后一个覆盖前一个”成为未记录的默认行为。

发布前的命名检查表

检查一条日志时，先列出完整组路径，再检查每个字段的归属；确认空组名没有被当成隔离层；确认同名字段只在不同业务域出现；最后分别看文本和 JSON 输出是否仍能表达相同的层级。如果接入日志平台，还要检查索引规则是否把动态组名当成高基数字段。

相关问题

WithGroup 会修改原来的 Handler 吗？按 Handler 契约应返回带新组的 Handler，调用方不应假设原 Handler 被原地修改；自定义实现尤其要复制组栈。

空字符串组名能解决字段冲突吗？不能。空组名不形成有意义的命名空间，应该重新设计业务组名或字段名。

TextHandler 和 JSONHandler 的组名表现一样吗？语义一致但展示形态不同，文本通常使用带前缀的键，JSON 更接近嵌套对象；要分别测试解析和检索规则。