Go slog.Record.Attrs 在自定义 Handler 中遍历日志字段的实现方法

用 Go 的 log/slog 写自定义 Handler 时，读取当前日志字段最直接的入口就是 slog.Record.Attrs：它按记录中的属性顺序调用回调，回调返回 true 继续，返回 false 停止。把这层边界记住，Handle 就不必自己猜测底层字段布局。

官方文档：https://pkg.go.dev/log/slog#Record.Attrs

Record.Attrs 读取的范围与顺序

一个日志调用会形成 slog.Record，记录里包含时间、级别、消息和通过 LogAttrs 等方法追加的属性。Record.Attrs 不返回切片，而是把每个 slog.Attr 交给回调；这让 Handler 可以边读边决定是否继续，也避免为了遍历而复制整组字段。

下面的 Handler 只收集当前记录里的非零属性。代码中的注释说明了停止条件，示例没有把输出描述成真实运行截图。

package main

import (
	"context"
	"log/slog"
)

type collectingHandler struct{}

func (collectingHandler) Enabled(context.Context, slog.Level) bool { return true }

func (collectingHandler) Handle(_ context.Context, r slog.Record) error {
	fields := make([]slog.Attr, 0, 4)
	r.Attrs(func(a slog.Attr) bool {
		// 零值 Attr 没有实际字段，跳过后继续读取剩余属性。
		if a.Equal(slog.Attr{}) {
			return true
		}
		fields = append(fields, a)
		// 返回 true 表示继续遍历；需要提前结束时返回 false。
		return true
	})
	_ = fields // 这里可以交给编码器或自定义输出层。
	return nil
}

func (collectingHandler) WithAttrs([]slog.Attr) slog.Handler { return collectingHandler{} }
func (collectingHandler) WithGroup(string) slog.Handler       { return collectingHandler{} }

如果只需要找到某个键，可以在回调中比较 a.Key，找到后返回 false。这比遍历结束后再扫描一遍更清楚，也把“读取全部字段”和“读取一个字段”区分开了。

Group 属性要保留结构关系

slog.Group 产生的属性仍然是一个 Attr，只是它的 Value 是分组值。自定义 Handler 如果直接调用 a.Value.String()，很容易丢掉组名和子字段关系；更稳妥的做法是先判断 Kind，再递归处理子属性或交给支持 Group 的编码器。

func visitAttr(a slog.Attr, prefix string) {
	// Resolve 让自定义 LogValuer 先给出最终可观察值。
	resolved := a.Value.Resolve()
	if resolved.Kind() != slog.KindGroup {
		// 普通字段保留完整键名和值，不把值提前格式化成日志文本。
		_ = prefix + a.Key
		_ = resolved
		return
	}
	for _, child := range resolved.Group() {
		// 组内字段使用前缀表达层级，避免与外层同名字段混淆。
		visitAttr(child, prefix+a.Key+".")
	}
}

示例只表达数据关系，真实 Handler 仍要决定如何编码、如何处理空键以及是否保留原始 Attr。如果目标是脱敏，应该把规则放在明确的属性处理层，不要在遍历时悄悄改写所有值。

三个边界先分清，再决定实现

工程上可以先做一个小选择：只需要输出当前字段时，在 Handle 里用 Record.Attrs；需要兼容预绑定字段时，把 WithAttrs 的缓存与当前记录分开建模；需要统一脱敏时，再考虑 ReplaceAttr 或共享的属性转换函数。这样每层的输入范围都能解释清楚。

相关问题

Record.Attrs 能修改原来的属性吗？

它提供的是遍历回调。若要生成修改后的记录，应先克隆或新建记录，再把处理后的属性追加到目标记录，避免把读取动作和原地修改混为一谈。

为什么只遍历 Record.Attrs 会漏字段？

最常见原因是把 WithAttrs 预绑定字段当成当前记录字段。它们可能已经被 Handler 保存，是否输出要由 Handler 的组合实现决定。

遇到 Group 应该转成字符串吗？

如果下游仍是结构化日志，不建议提前转字符串；保留键、值和分组层级，后续编码器才有机会正确表达嵌套字段。