如何在slog日志器中传入结构体并自动使用其字段？

你可以通过两种方式实现需求，下面分别说明：

方法一：让结构体实现slog.LogValuer接口（推荐） #

这是最贴合slog设计理念的方案，不需要修改Handler，只需要给你的结构体添加LogValue方法，让slog自动将结构体转换为日志字段组。

假设你的结构体类型是Message，示例代码如下：

type Message struct {
    route Route
    // 其他字段
}

type Route struct {
    destination string
    protocol    string
    serID       string
}

// 给Message类型实现LogValuer接口
func (m Message) LogValue() slog.Value {
    return slog.GroupValue(
        slog.String("Destination", m.route.destination),
        slog.String("Protocol", m.route.protocol),
        slog.String("Service Identifier", m.route.serID),
        slog.String("Session ID", m.GetIdentifier()),
    )
}

之后你就可以按照预期的方式调用日志方法：

g.l.Log(
    context.TODO(),
    slog.LevelInfo,
    "Sending request to server.",
    "message", m,
    "Client Connection", client.RemoteAddr().String(),
    "Server Connection", destination.RemoteAddr().String(),
)

slog会自动解析m的LogValue方法返回的字段组，最终日志输出效果和逐个传参完全一致。

方法二：自定义Handler展开结构体 #

如果无法修改目标结构体（比如是第三方库的类型），可以自定义Handler包装原Handler，在处理日志记录时自动展开指定结构体的字段。

示例代码：

// 自定义Handler，用于展开特定结构体
type StructUnwrapHandler struct {
    slog.Handler
}

func (h StructUnwrapHandler) Handle(ctx context.Context, r slog.Record) error {
    var processedAttrs []slog.Attr
    // 遍历日志记录中的所有属性
    r.Attrs(func(a slog.Attr) bool {
        // 判断当前属性值是否是目标结构体类型
        if msg, ok := a.Value.Any().(Message); ok {
            // 将结构体转换为多个日志字段
            processedAttrs = append(processedAttrs,
                slog.String("Destination", msg.route.destination),
                slog.String("Protocol", msg.route.protocol),
                slog.String("Service Identifier", msg.route.serID),
                slog.String("Session ID", msg.GetIdentifier()),
            )
        } else {
            // 非目标类型直接保留原属性
            processedAttrs = append(processedAttrs, a)
        }
        return true
    })

    // 创建新的日志记录，替换处理后的属性
    newRecord := slog.NewRecord(r.Time, r.Level, r.Message, r.PC)
    newRecord.AddAttrs(processedAttrs...)

    // 交给原Handler处理新记录
    return h.Handler.Handle(ctx, newRecord)
}

// 使用自定义Handler初始化日志器
logger := slog.New(StructUnwrapHandler{Handler: slog.Default().Handler()})

注意事项 #

• 如果结构体包含未导出字段（小写开头），要确保LogValue方法或Handler能访问到这些字段（比如通过结构体的公开方法获取）。
• 方法一的侵入性更低，后续维护成本小，优先推荐使用。

内容的提问来源于stack exchange，提问作者dana darvishzadeh