Go log/slog 的属性组附加方法

在请求日志里，如果方法、路径和状态码总是一起出现，把它们平铺在日志调用中会让调用点变长。log/slog.Group 的作用就是把多个属性收拢到一个组键下：组键是第一个参数，后面的参数按 Logger.Log 的属性规则转换，最终返回一个 slog.Attr。

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

固定数量、固定结构的属性可以直接用 slog.Group；如果属性已经放在 []slog.Attr 中，用 slog.GroupAttrs 更自然；如果同一组字段要跟随多条日志，再考虑 Logger.WithGroup。

先看清 slog.Group 的参数关系

slog.Group(key string, args ...any) slog.Attr 的第一个参数是组键，例如 req；剩余参数可以是 slog.String、slog.Int 这样的 Attr，也可以使用交替的字符串键和值。函数返回的是一个带 Group Value 的属性，交给 Logger 或 Handler 后才会表现为分层字段。

用 Group 组织一次请求日志

下面的场景是一次请求结束时同时记录方法、路径和状态码。组内字段保持同一层级，调用点也能看出这些字段属于请求上下文。

package main

import (
	"log/slog"
	"os"
)

func main() {
	// TextHandler 便于观察组键如何出现在最终日志字段中。
	logger := slog.New(slog.NewTextHandler(os.Stdout, nil))

	logger.Info("request finished",
		// 固定结构的请求属性集中放进 req 组。
		slog.Group("req",
			slog.String("method", "GET"),
			slog.String("path", "/users"),
			slog.Int("status", 200),
		),
	)
}

这里的 req 不会丢失，它是组的命名空间。内置文本处理器通常会把字段表达成类似 req.method、req.path 的层级键；JSON 处理器则会把它们组织成嵌套对象。具体外观由 Handler 决定，但属性归属仍由 Group 表达。

Group、GroupAttrs 与 WithGroup 怎么选

三种写法解决的不是完全相同的问题。Group 适合少量、固定的属性参数；GroupAttrs 适合属性已经在切片中动态累积的情况；WithGroup 则把组名放进一个新的 Logger，后续多条日志都可以复用。

package main

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

func main() {
	// 复用同一个 Handler，方便比较三种属性组入口。
	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

	// 属性数量固定，直接把 Attr 作为 Group 的参数传入。
	logger.LogAttrs(context.Background(), slog.LevelInfo, "fixed",
		slog.Group("req", slog.String("method", "GET")))

	attrs := []slog.Attr{
		slog.String("method", "POST"),
		slog.Int("status", 201),
	}
	// 动态切片已经准备好时，用 GroupAttrs 避免重新拆成交替参数。
	logger.LogAttrs(context.Background(), slog.LevelInfo, "dynamic",
		slog.GroupAttrs("req", attrs...))

	requestLogger := logger.WithGroup("req")
	// 同一组要覆盖多条事件时，让派生 Logger 持有组上下文。
	requestLogger.Info("validated", slog.Bool("ok", true))
	requestLogger.Info("stored", slog.String("table", "users"))
}

选择规则可以压缩成一句话：属性就在调用点且数量固定，用 Group；属性来自可变切片，用 GroupAttrs；同一个组要连续影响多条日志，用 WithGroup。不要为了“看起来统一”把一次性属性强行改成派生 Logger。

处理空键、空组和动态属性

空组键有特殊含义：组内属性会被内联到当前层，而不是多出一个空名称的层级。这个行为适合把一组可选属性直接展开，但如果调用者依赖固定的 req. 前缀，就不要把组键写成空字符串。

如果组里没有有效属性，Handler 通常不会输出一个空组。动态切片因此可以先按条件追加，再一次性传给 GroupAttrs。切片由调用者维护，日志调用完成前不要并发修改；每个请求的属性切片也应独立，避免不同请求互相污染。

func requestAttrs(debug bool) slog.Attr {
	attrs := []slog.Attr{slog.String("method", "GET")}
	if debug {
		// 可选字段只在需要时加入，保持普通日志更紧凑。
		attrs = append(attrs, slog.Bool("debug", true))
	}
	// 空键表示把这组属性内联到当前层，按需求决定是否使用。
	return slog.GroupAttrs("req", attrs...)
}

用 Handler 判断最终层级

Group 描述的是属性关系，不承诺所有 Handler 使用同一种文本格式。切换 TextHandler 和 JSONHandler 时，应该关注字段是否仍属于同一个组，而不是只比较字符串长相。自定义 Handler 也应遵守 Group 的语义：有名字的组形成层级，空键组内联，没有属性的组可以忽略。

如果日志字段没有出现在预期位置，按这三个方向排查：组键是否为空或拼写错误；是否把属性放到了另一个 Logger 的 WithGroup 作用域；Handler 是否在处理 Group 时改变了展示方式。先确认属性关系，再判断格式差异。

常见问题

slog.Group 的后续参数必须全部是 Attr 吗？

不必须。它会按日志参数规则处理 Attr，或者把字符串键与后一个值组合成属性；为了减少歧义和获得更清晰的类型表达，固定字段更推荐直接使用 slog.String、slog.Int 等构造函数。

Group 和 WithGroup 输出一样吗？

在单条事件的字段层级上可能相似，但作用范围不同。Group 只附加到当前调用，WithGroup 会影响派生 Logger 后续的多条日志。

为什么动态切片不直接传给 Group？

Group 接受可变参数，切片需要展开；语义上也更适合用专门接收 []slog.Attr 的 GroupAttrs 表达数据来源。

总结：把固定属性收拢到一个命名空间时使用 slog.Group，把已有属性切片包装成组时使用 slog.GroupAttrs，让组跨多条日志复用时使用 Logger.WithGroup；空键、空组和 Handler 格式差异则是最值得提前说明的边界。