Go log/slog Logger.WithGroup 怎样组织嵌套日志字段

直接结论：log/slog.Logger.WithGroup("request") 会返回一个使用同一 Handler 的新 Logger，并把这个 Logger 后续加入的属性放进 request 命名空间。TextHandler 通常把它显示成点号路径，JSONHandler 则显示成嵌套对象。它适合给子系统隔离同名字段，不等同于一次调用里的 slog.Group 属性。

官方参考：https://pkg.go.dev/log/slog#Logger.WithGroup

先区分 Group 属性和 WithGroup

slog.Group 是一条日志记录中的属性；WithGroup 是 Logger 的派生方法。前者适合只给当前事件加一个结构，后者适合把同一组名应用到一个子系统后续产生的多条日志。

package main

import (
	"log/slog"
	"os"
)

func main() {
	// JSONHandler 把结构化字段写成 JSON，便于下游按字段检索。
	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

	// Group 只影响当前这条记录，适合一次性组合请求字段。
	logger.Info("一次请求", slog.Group("request",
		slog.String("method", "GET"),
		slog.String("url", "/items"),
	))

	// WithGroup 返回派生 Logger，后续属性都会带上 parser 命名空间。
	parserLogger := logger.WithGroup("parser")
	parserLogger.Info("解析完成", "id", 42)
}

可以把 Group 理解为“本条记录的嵌套属性”，把 WithGroup 理解为“这个 Logger 的字段前缀”。两者都不会把普通字符串拼成一段不可解析的日志文本。

用 WithGroup 给子系统建立字段命名空间

大型程序里不同模块经常都会使用 id、status 或 error 这样的通用键。如果所有模块都把这些键直接写到根层，日志聚合后容易出现覆盖或歧义。可以先在公共 Logger 上保留进程级字段，再给每个子系统派生不同的组。

// 公共属性保留在根层，方便所有日志按进程或实例过滤。
base := slog.Default().With("id", "service-7")

// 子系统使用独立命名空间；即使它再次写入 id，也不会和根层字段混淆。
parserLogger := base.WithGroup("parser")
parserLogger.Info("读取输入", "id", "file-42", "format", "json")

这时逻辑上存在根层的公共 id，也存在 parser 组里的 id。它们表达的是不同对象：前者是服务实例，后者是解析任务。WithGroup 返回的是新 Logger，原来的 base 仍可继续用于其它模块。

同一组在 TextHandler 与 JSONHandler 中怎样呈现

组的逻辑含义由 Handler 决定具体格式。官方文档给出的规则是：TextHandler 用点号连接组名和字段名，JSONHandler 把组名作为对象键。因此不要把某一种输出的字符串形态写死到业务逻辑里，业务侧只需要维护稳定的组名和字段名。

// 这个 Logger 的字段都属于 request 组。
requestLogger := slog.New(slog.NewTextHandler(os.Stdout, nil)).WithGroup("request")

// 中文注释说明字段用途；method 和 url 会被 Handler 放在 request 组下。
requestLogger.Info("收到请求", "method", "GET", "url", "/items")

在 TextHandler 中，字段通常呈现为类似 request.method=GET request.url=/items 的限定名；在 JSONHandler 中则类似 "request":{"method":"GET","url":"/items"}。这里的两段结果是格式说明，不是本机执行截图。

空组和嵌套组要怎么处理

WithGroup 的组名为空时，返回接收者本身，不会凭空增加一层字段。这个行为适合把可选组名直接传给公共封装，但不能把空字符串当成一个可查询的命名空间。

func scopedLogger(logger *slog.Logger, group string) *slog.Logger {
	// 空组名由 slog 保持原 Logger，避免产生无意义的层级。
	return logger.WithGroup(group)
}

// 嵌套组可以表达模块与操作的层级，但组名应保持稳定、简短。
logger := slog.Default().WithGroup("parser").WithGroup("input")
logger.Info("读取完成", "bytes", 128)

嵌套组会让输出层级继续增加。建议只把它用于确实存在的模块边界，例如 parser.input；如果只是为了让日志看起来整齐而不断加组，查询和字段治理都会变复杂。

常见问题

WithGroup 会修改原 Logger 吗？不会。它返回一个带有同一 Handler 的新 Logger，原 Logger 的调用方式保持不变。

为什么文本日志和 JSON 日志看起来不一样？因为组的展示由 Handler 决定；点号路径和嵌套对象是两种编码方式，逻辑上的组名和字段关系仍然相同。

小结

• 一次日志记录的临时结构使用 slog.Group，子系统长期复用的命名空间使用 Logger.WithGroup。
• WithGroup 能隔离同名字段；TextHandler 与 JSONHandler 只是采用不同展示形态。
• 空组不会增加层级，嵌套组应服务于稳定的模块边界。