Go slog.Handler.WithGroup 如何组织结构化日志：嵌套字段与处理器链路

订单服务已经统一换成 log/slog，但日志检索仍然像一串散落的键值：service、request_id、db 混在同一层，看到数据库字段时很难判断它属于哪一步。这个问题不在 JSON 编码，而在 Handler 没有把上下文组织成组。

问题现场：字段都在，却看不出归属

先看一个最小场景：请求处理器想把数据库查询信息归到 db 组里，同时保留请求级字段。

package main

import (
    "log/slog"
    "os"
)

func main() {
    handler := slog.NewJSONHandler(os.Stdout, nil)
    logger := slog.New(handler).With("service", "orders")
    logger.Info("query finished",
        "request_id", "r-2048",
        "db", "orders",
        "rows", 3,
    )
}

这段日志能工作，但 db 只是普通字符串。后续再增加 table、duration_ms 时，调用点会不断重复字段名，字段之间也没有明确边界。

先看 Handler 链路：WithGroup 到底改变了什么

WithGroup 的关键不是给日志增加一个标签，而是返回一个带组状态的 Handler。下面把请求级 Handler 和数据库级 Handler 分开，调用者仍然使用同一个 logger 对象记录事件。

handler := slog.NewJSONHandler(os.Stdout, nil)
requestHandler := handler.WithAttrs([]slog.Attr{
    slog.String("service", "orders"),
})
dbHandler := requestHandler.WithGroup("db")
logger := slog.New(dbHandler)

logger.Info("query finished",
    slog.String("table", "orders"),
    slog.Int("rows", 3),
)

这里的调用链是 requestHandler 先保存 service，dbHandler 再保存 db 组，最后由 logger 把事件和属性交给当前 Handler。WithGroup 不会把原 Handler 改成数据库 Handler，所以同一个基础 Handler 还可以派生出 cache 或 http 组。

动手验证：让 JSON 输出体现字段边界

把组放在日志器上，组内属性就不必每次写前缀。这个例子同时保留请求级字段和数据库级字段，运行后检查 service、db、table 三个位置。

func main() {
    handler := slog.NewJSONHandler(os.Stdout, nil)
    logger := slog.New(handler).
        With(slog.String("service", "orders"), slog.String("request_id", "r-2048"))

    dbLogger := logger.WithGroup("db")
    dbLogger.Info("query finished",
        slog.String("table", "orders"),
        slog.Int("rows", 3),
    )
}

预期结果是：service 和 request_id 留在顶层，table 和 rows 位于 db 对象中。若看到所有字段仍在顶层，通常是把 logger 而不是 dbLogger 用在了这条日志上。

同名组与空组：两个容易误判的边界

组名不是一次性的开关。连续调用 WithGroup("db") 会形成嵌套路径，适合表达驱动器和连接池这样的层级，但不适合为了“分类”随意重复命名。

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.WithGroup("db").WithGroup("pool").Info("checked",
    slog.Int("idle", 4),
)

没有属性的空组不会凭空产生一个有意义的字段对象；真正决定输出结构的是组内是否写入属性。实践中应让组紧贴一段有稳定字段集合的调用路径，不要把所有日志都包进一个过大的 context 组。

复查结果：把组当作结构，而不是字符串前缀

如果日志消费者需要按字段检索，优先使用 WithGroup 表达数据边界；如果只是临时增加一个单值标签，普通的 With 更直接。两者可以组合，但要在代码评审时明确哪一级负责请求字段，哪一级负责业务对象字段。

常见问题：WithGroup 的使用选择

WithGroup 会修改已有的 Handler 吗？

不会。它返回一个带有新组状态的 Handler，原 Handler 仍可用于其他日志器。

为什么字段没有进入 db 对象？

最常见原因是调用了原来的 logger，而不是 logger.WithGroup("db") 返回的日志器。

普通字段和组字段可以同时存在吗？

可以。请求标识等稳定上下文适合放顶层，查询表名、行数等局部属性适合放进 db 组。

小结：先划边界，再决定字段写法

With 解决“给每条日志带上什么值”，WithGroup 解决“这些值属于哪一层”。先按请求、数据库、缓存等稳定边界派生 Handler，再在具体事件中写局部属性，JSON 日志会更容易检索，也更不容易发生同名字段覆盖。