Go log/slog ReplaceAttr 怎样统一改写时间和来源字段

Go 的 log/slog 已经把日志级别、时间、来源位置和业务属性统一成结构化字段。需要统一日志格式时，不必修改每一处 logger.Info 调用，直接在 slog.HandlerOptions 中设置 ReplaceAttr 即可。它能删除顶层时间、重命名来源字段，也能把时间转换成固定格式；关键是要根据 groups 判断字段层级，避免把业务分组里的同名字段一起改掉。

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

ReplaceAttr 的回调边界：先分清 groups 和 Attr

ReplaceAttr 的签名是 func(groups []string, a slog.Attr) slog.Attr。回调收到的 a 已经是一个具体属性，Group 本身不会作为一个整体传入；如果属性来自 slog.Group("req", ...)，groups 中会出现 req。因此，判断 len(groups) == 0 是保护内置字段的第一道边界。

package main

import "log/slog"

// 只改写顶层属性，避免误伤 req 分组中的业务字段。
func normalizeAttr(groups []string, a slog.Attr) slog.Attr {
	if len(groups) == 0 && a.Key == slog.TimeKey {
		// 返回零值 Attr 表示删除时间字段。
		return slog.Attr{}
	}
	return a
}

这里的判断不是为了限制所有字段，而是把“统一处理 Handler 生成的内置字段”和“保留业务数据原样”分开。若确实要处理某个分组，应明确匹配 groups 的内容，而不是只看键名。

把 time 和 source 变成稳定输出

时间字段常见的两种处理是删除和格式化。删除适合日志平台已经统一写入采集时间的场景；格式化适合文本日志需要固定时区或固定布局的场景。来源字段则依赖 HandlerOptions.AddSource：不开启时通常没有 source 可改写。

package main

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

// 统一内置键名；只处理顶层字段，业务属性和分组结构保持不变。
func replaceBuiltin(groups []string, a slog.Attr) slog.Attr {
	if len(groups) != 0 {
		return a
	}
	switch a.Key {
	case slog.TimeKey:
		// 不需要重复输出采集时间时，删除 time。
		return slog.Attr{}
	case slog.SourceKey:
		// Source() 的值是结构化对象；这里用短文本保留文件和行号语义。
		if src := a.Value.Any(); src != nil {
			text := strings.TrimSpace(a.Value.String())
			if text != "" {
				return slog.String("source_ref", text)
			}
		}
	}
	return a
}

func main() {
	// AddSource 才会让 Handler 计算并输出 source 字段。
	options := &slog.HandlerOptions{AddSource: true, ReplaceAttr: replaceBuiltin}
	logger := slog.New(slog.NewJSONHandler(os.Stdout, options))
	logger.Info("request finished", slog.String("status", "ok"))
}

示例的核心是回调返回值：零值 Attr 代表丢弃，新的 Attr 代表替换，原 Attr 代表保留。实际项目中如果要保留来源的文件、行号和函数名，建议读取 slog.Source 的字段后重新组装，而不是依赖一段展示字符串。这样 JSON Handler 的字段类型更稳定。

文本和 JSON Handler 共享规则，但输出形态不同

ReplaceAttr 属于 HandlerOptions，因此 TextHandler 与 JSONHandler 都会调用它。相同的是字段是否删除、键名是否替换以及 groups 的边界；不同的是最终序列化格式。不要用文本日志里“看起来像路径”的结果去推断 JSON 中的字段类型。

验收时至少分别构造一个顶层属性和一个 slog.Group("req", ...) 属性。前者应按规则改写，后者应保持嵌套关系；再分别换成文本和 JSON Handler，确认只是序列化外观变化。

常见问题

为什么 ReplaceAttr 没有收到 source？

通常是 AddSource 没有设置为 true，或者当前 Handler 没有生成该内置字段。先检查 HandlerOptions，再看回调是否只对顶层字段做判断。

返回空 Attr 会影响业务字段吗？

只会影响当前回调收到的那个属性。若条件只匹配顶层 time 或 source，分组中的业务字段不会被删除。

能否在 ReplaceAttr 中保存 groups 切片？

不建议。groups 只在回调期间描述当前路径，按文档约定不应保留或修改；需要记录上下文时应立即复制所需字符串。