Go slog.WithAttrs 如何减少重复字段：属性快照、分组继承与日志输出

HTTP 服务把请求 ID、租户和处理器名称写进每一条日志时，最容易出现的不是字段缺失，而是调用点重复堆参数。Go 标准库的 log/slog 可以先用 Logger.WithAttrs 固定一组属性，再在请求内部补充局部字段；如果再配合 WithGroup，输出结构也能保持稳定。

先把重复的请求字段移到 Logger 上

下面这个场景很常见：入口已经拿到 req_id 和 tenant，业务函数又要记录 handler。如果每次都写成一串键值对，调用点既长，又容易漏掉其中一个字段。

base := slog.New(slog.NewJSONHandler(os.Stdout, nil))
requestLog := base.With(
    slog.String("req_id", "r-2048"),
    slog.String("tenant", "acme"),
)

requestLog.Info("开始处理", slog.String("handler", "orders"))
requestLog.Info("读取订单", slog.Int("count", 3))

Logger.With 接收可变参数，内部会把参数转换成属性；需要直接复用已经整理好的 []slog.Attr 时，可以使用 WithAttrs。这两个入口解决的是同一类问题，但后者更适合属性已经由中间件或工厂函数准备好的情况。

WithAttrs 保存的是属性集合，不是一次性的打印文本

可以把请求上下文拆成一个不可复用的切片，再通过 WithAttrs 创建子 Logger：

attrs := []slog.Attr{
    slog.String("req_id", "r-2048"),
    slog.String("tenant", "acme"),
}
requestLog := base.WithAttrs(attrs)
requestLog.Info("进入处理器")

这里的重点是“属性”，不是已经拼好的字符串。标准 Handler 会在处理日志记录时把这些属性与当前记录合并。不同 Handler 可以采用不同的格式和预处理策略，因此不要把某个 JSON 输出样式当成所有 Handler 的永久排序保证。

WithGroup 解决的是字段命名空间

如果日志接收端约定请求字段都位于 request 下，可以先建立分组，再附加属性：

requestLog := base.WithGroup("request").WithAttrs([]slog.Attr{
    slog.String("id", "r-2048"),
    slog.String("tenant", "acme"),
})
requestLog.Info("查询完成", slog.Int("count", 3))

使用 JSONHandler 时，结果会呈现为类似 "request":{"id":"r-2048","tenant":"acme","count":3} 的嵌套对象。WithGroup 的分组会影响它之后的属性；如果先写入顶层属性再调用它，两者就不在同一个命名空间里。

用一个最小程序核对继承、重复键和求值时机

不要只凭肉眼猜字段归属，下面的程序可以直接保存为 main.go，执行 go run . 查看 JSON：

package main

import (
    "log/slog"
    "os"
)

func main() {
    h := slog.NewJSONHandler(os.Stdout, nil)
    log := slog.New(h).WithGroup("request").WithAttrs([]slog.Attr{
        slog.String("id", "r-2048"),
        slog.String("tenant", "acme"),
    })
    log.Info("查询完成", slog.Int("count", 3))
}

核对时只看三件事：request 是否出现为对象、id 与 tenant 是否位于对象内、count 是否和它们处于同一分组。若改用 slog.NewTextHandler，展示形式会变成带点号的键名，这是 Handler 的格式选择，不代表 Logger 丢了分组。

几个容易误判的边界

• 同名键不会自动去重。父 Logger、子 Logger 和当前日志记录都可能提供同名属性，如何呈现应以所用 Handler 的契约和实际输出为准。
• 不要修改已经交给 Logger 的可变数据后再猜结果。需要动态值时，可显式使用 slog.LogValuer，并在测试中核对 Handler 的求值时机。
• 空分组名不是“回到上一层”。空组名不会开启新的命名空间，但也不应把它当作通用的分组撤销 API。
• 业务字段和请求字段分开命名。请求级字段统一放进 request 后，检索规则更清晰，也减少不同模块都使用 id 造成的歧义。

相关问题

With 和 WithAttrs 该怎么选？

临时写几项属性时用 With 更直观；属性已经是 []slog.Attr 或由中间件统一生产时，用 WithAttrs 更顺手。

WithGroup 会改变日志消息或级别吗？

不会。它主要改变后续属性的分组位置，消息、级别和时间仍由当前日志调用与 Handler 处理。

TextHandler 和 JSONHandler 的分组表现一样吗？

语义上都遵守分组边界，但文本键名和 JSON 嵌套对象的展示不同，最终检索规则应按线上 Handler 的实际格式配置。

小结

把稳定的请求字段放到 WithAttrs 创建的 Logger 上，再用 WithGroup 划出命名空间，日志调用点会短很多。真正上线前，保留一个 JSONHandler 的最小测试，核对分组、重复键和动态值三类边界，通常比盯着某一行输出猜实现更可靠。