Go log/slog Value.Resolve 怎样展开延迟计算字段

在 Go 的 log/slog 里，想把昂贵字段延迟到真正写日志时再计算，可以让类型实现 slog.LogValuer。但自定义 Handler 遍历属性时，不能把“调用一次 Resolve”理解成所有嵌套字段都会自动展开。

最稳妥的做法是：对当前 slog.Attr.Value 调用 Resolve，如果结果是 KindGroup，再显式遍历 Group() 返回的子属性；Value.Resolve 本身不会递归解析 Group 内部的值。

官方地址：https://pkg.go.dev/log/slog#Value.Resolve

Value.Resolve 先解决什么问题

LogValuer 只有一个 LogValue() slog.Value 方法。它适合包装一次计算成本较高、但可能因为日志级别被丢弃而根本不需要计算的字段。Value.Resolve 会在当前值仍然实现 LogValuer 时反复调用 LogValue，直到得到最终值；返回值不会再是 KindLogValuer。

下面的类型把请求摘要延迟成一个 Group。代码中的注释保留了输入、展开和错误边界，适合作为一个最小的日志小项目起点。

package main

import "log/slog"

type requestSummary struct {
	method string
	route  string
}

// LogValue 只在 Handler 需要消费这个字段时组装结构化属性。
func (r requestSummary) LogValue() slog.Value {
	return slog.GroupValue(
		slog.String("method", r.method), // 保留请求方法，便于按字段检索。
		slog.String("route", r.route),   // 路由是延迟计算结果的一部分。
	)
}

func main() {
	attr := slog.Any("request", requestSummary{method: "GET", route: "/orders"})
	resolved := attr.Value.Resolve()
	_ = resolved // 这里得到 Group；Group 内部还要按需遍历。
}

在自定义 Handler 中展开单个属性

普通的内置 Handler 会负责日志值的常规格式化；只有当你需要自定义字段采集、脱敏或转发时，才通常会在自己的 Handler 里主动调用 Resolve。先处理当前属性，再根据 Kind 判断是否为 Group，是最容易读懂的边界。

func writeAttr(attr slog.Attr) {
	value := attr.Value.Resolve() // 先展开当前 LogValuer，避免把接口值原样传下去。
	if value.Kind() != slog.KindGroup {
		consume(attr.Key, value) // 标量值直接交给下游，包含 Resolve 产生的错误值。
		return
	}

	// Group 的子属性不会由 Resolve 自动递归，这里显式展开一层。
	for _, child := range value.Group() {
		writeAttr(child)
	}
}

func consume(key string, value slog.Value) {
	// 真实项目可在这里写入字段映射、脱敏结果或下游事件。
	_ = key
	_ = value
}

这个写法的关键不是把所有值都转成字符串，而是保留 slog.Value 的 Kind。这样调用方仍能区分字符串、整数、时间、错误和 Group；如果只需要一层字段，也可以在 Group 分支里直接收集子属性，不必继续递归。

Group 为什么还要手动遍历

官方语义明确区分了“当前 Value 的解析”和“Group 内属性的解析”：当当前值解析成 Group 时，Group 内部属性的 Value 不会被递归 Resolve。因此 slog.GroupValue 里如果又放入一个实现 LogValuer 的字段，外层 Resolve 只负责把外层变成 Group。

如果你的 Handler 从完整记录开始，可以配合 Record.Attrs 遍历属性：

func handleRecord(record slog.Record) {
	record.Attrs(func(attr slog.Attr) bool {
		writeAttr(attr) // 每个顶层属性都走同一个 Resolve 与 Group 边界。
		return true     // 返回 false 才会提前停止遍历。
	})
}

注意，Group 的递归深度应该由业务决定。日志字段结构固定时，可以只展开一层；结构允许嵌套时，才让 writeAttr 递归，并为异常深度设置自己的保护。

递归、错误与内置 Handler 的取舍

如果多个 LogValuer 互相返回对方，Resolve 不会无限调用；超过内部阈值后会返回一个包含错误的 Value。自定义 Handler 不应把这个错误静默丢掉，可以按字段记录错误或保留原始键名，避免日志看起来像“字段凭空消失”。

不需要改字段结构时，优先交给 TextHandler 或 JSONHandler。需要把属性映射到指标、事件或脱敏模型时，再在 Handler 中使用上面的显式解析。这样既能利用 LogValuer 的延迟计算，也能清楚控制 Group 的递归边界。

常见问题

Resolve 会把 Group 的所有子字段一起解析吗？

不会。它只反复解析当前 Value；如果结果是 Group，子属性仍需通过 Group() 取出后自行处理。

为什么不直接调用 Value.LogValuer？

LogValuer() 只适合确认或取得实现接口的值，真正把链式 LogValuer 展开并得到非 KindLogValuer 结果，应使用 Resolve()。

小结

• LogValuer 负责把昂贵字段延迟到需要时计算。
• Value.Resolve 负责解析当前值，不负责 Group 子属性的递归。
• 自定义 Handler 应保留 Value Kind，并明确标量、Group 和错误值的处理边界。