Go slog.Logger.WithGroup 怎么组织嵌套字段：空组名、属性归属与 JSON 输出边界

订单服务把请求、数据库和下游调用都写进同一条 JSON 日志后，最容易乱的不是字段数量，而是字段归属：request.id、db.sql 和 downstream.code 到底是不是同一层。Go 的 slog.Logger.WithGroup 可以把相关属性收进命名组，但它有一个经常被忽略的边界：传入空字符串时不会产生嵌套层，组名是否真正出现在输出里还要看 Handler 的处理规则。

先看一条被分组的 JSON 日志

假设网关给订单服务传入 trace_id，服务还要记录数据库耗时。把字段平铺出来当然能查，但一旦同一条记录同时出现两个 duration_ms，排查时就得依赖字段命名约定。分组的价值在于把命名空间写进日志结构，而不是在字段名前手工拼接点号。

logger.WithGroup("request").With(
    slog.String("id", "tr-7f2"),
    slog.String("method", "POST"),
).Info("order created")

使用标准 slog.NewJSONHandler 时，输出会接近下面的结构：

{"time":"...","level":"INFO","msg":"order created","request":{"id":"tr-7f2","method":"POST"}}

这里的 request 不是一段字符串前缀，而是 JSON 对象层级。后续再调用 WithGroup("db")，就可以让数据库字段进入另一块命名空间。

WithGroup 的三个边界要先记住

空组名不是“名字为空的对象”。源码层面的处理是跳过空组，因此下面两种写法在结构上并不等价：

logger.WithGroup("").Info("flat")
logger.WithGroup("request").WithGroup("").Info("still in request")

第一条保持平铺，第二条仍处于 request 组中。这个细节适合用在“可选子模块”场景：配置没有子模块名时，不会凭空多出一层 JSON。

把组名放进一次可验证的流水线

按“服务级字段 → 请求组 → 数据库组”的顺序构造 Logger，阅读和复用都比较稳。服务级字段只绑定一次，请求级字段跟着请求生命周期走，数据库字段则在真正访问数据库的边界上加入。

package main

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

func main() {
    var buf bytes.Buffer
    base := slog.New(slog.NewJSONHandler(&buf, &slog.HandlerOptions{Level: slog.LevelInfo}))
    logger := base.With(slog.String("service", "orders"))
    logger.WithGroup("request").With(
        slog.String("id", "tr-7f2"),
        slog.Int("attempt", 1),
    ).WithGroup("db").Info("query finished", slog.Int64("duration_ms", 12))

    os.Stdout.Write(buf.Bytes())
}

核对结果时只看三点：service 是否在顶层，request 是否包含 id 和 attempt，以及 db.duration_ms 是否落在 request 下面。若你希望 db 与 request 同级，就不能在已经进入 request 组的 Logger 上继续调用 WithGroup("db")，而应从同一个 logger 分支创建。

重复组名和属性归属怎么排查

生产代码里常见的误会是：看到两个同名组，就以为标准 Handler 一定会合并或覆盖。实际上 Handler 接收的是组和属性事件，具体如何编码由 Handler 实现决定；JSONHandler 的输出规则要以当前 Go 版本文档和测试结果为准。

排查时不要直接盯着终端的长日志。给 Handler 一个 bytes.Buffer，解析一条 JSON，再断言对象路径：

var got map[string]any
if err := json.Unmarshal(buf.Bytes(), &got); err != nil {
    t.Fatal(err)
}
request, ok := got["request"].(map[string]any)
if !ok {
    t.Fatal("request group missing")
}
_ = request["db"]

如果业务需要把同名组压平、丢弃敏感属性或改变键名，应实现并测试自己的 slog.Handler，不要把默认 JSON 输出猜测写进查询规则。

常见问题

WithGroup 只是给字段名前面加点号吗？

不是。对 JSONHandler 来说，它表达的是组层级；对其他 Handler，最终呈现形式可能不同。

空字符串组名会输出一个空 key 吗？

不会。标准 slog 约定空组名不创建组，属性会继续处在当前层级。

WithGroup 和 WithAttrs 应该怎么分工？

服务名、版本这类稳定字段适合 WithAttrs 或 With 固定；请求、数据库这类上下文边界适合 WithGroup。

怎样保证日志查询不会被实现细节带偏？

把期望的 JSON 路径写成单元测试，直接解析 Handler 输出；不要只用肉眼检查一条终端日志。

最后的使用清单

先确定字段归属，再决定是否建组；可选组名为空时保留当前层级；同一条日志需要跨多个阶段时，从同一个基准 Logger 分支创建同级组；最后用缓冲区测试核对真实 Handler 输出。这样 WithGroup 才是在管理日志结构，而不只是让字段名看起来更整齐。