Go语言slog日志使用详解

本文深入解析了 Go 语言标准库 slog 的正确使用方法，重点揭示了结构化日志的常见误区与最佳实践：默认 slog.Info 输出仅为扁平文本，无法被 Loki、ELK 等系统可靠解析；真正实现结构化必须显式创建 Logger 并选用 JSON 或 Text Handler；所有日志字段必须通过 slog.String、slog.Int 等类型化构造函数传入，否则会悄无声息生成难以排查的 !BADKEY；在 HTTP 服务中应通过中间件结合 slog.With 自动注入 trace_id，实现请求链路全程可追溯；最后强烈推荐引入 sloglint 工具，在编译前强制类型安全并拦截敏感字段，从源头杜绝日志混乱与安全风险——掌握这些，才能让 slog 成为可观测性建设的真正利器。

slog 默认输出不是结构化的，直接用 slog.Info 会得到类 log.Printf 的扁平文本，不是你想要的 JSON 或 key=value —— 想用结构化日志，必须自己新建 Logger 实例。

怎么让 slog 输出 JSON 或 key=value 格式

默认的 slog.Info 等函数走的是全局默认 Logger，背后用的是 TextHandler 的简化版（不带结构），输出形如 2026/03/28 09:10:22 INFO user login user_id=123，看着像结构化，实则只是空格分隔，无法被 Loki、ELK 稳定解析。

• 要真正结构化，得显式创建 Logger：用 slog.New(slog.NewJSONHandler(...)) 或 slog.New(slog.NewTextHandler(...))
• slog.NewJSONHandler(os.Stdout, nil) 输出标准 JSON，每行一个对象，机器友好
• slog.NewTextHandler(os.Stdout, nil) 输出 key=value 键值对，人眼可读，也支持解析（比如 Grafana Loki 的 `pattern` 提取）
• 两个 handler 都接受第二个参数 *slog.HandlerOptions，可用于控制时间格式、添加额外属性等

为什么不能直接传 "user_id", 123 而必须用 slog.Int("user_id", 123)

这是 slog 最容易翻车的地方：传原始键值对（"user_id", 123, "ip"）时，如果值数量是奇数，末尾缺值，slog 不报错，而是悄悄把最后一个 key 变成 !BADKEY —— 线上查日志时你会看到 "!BADKEY":"123"，根本找不到字段。

• 正确写法只有一种：slog.String("user_id", "u_abc")、slog.Int("status_code", 200)、slog.Bool("is_admin", true)
• 所有类型都有对应构造函数：slog.Float64、slog.Time、slog.Duration、slog.Group（用于嵌套结构）
• 编译器能帮你检查类型安全，比如 slog.Int("id", "abc") 直接编译失败，比运行时报错强得多

如何在 HTTP 请求中自动带上 trace_id 或 request_id

微服务里靠日志串联请求链路，关键就是每个 log 都得带上下文 ID。slog 本身不绑定 context，但可以靠 With + Handler.WithAttrs 实现“一次注入，全程携带”。

• 别在每个 logger.Info 里重复写 slog.String("trace_id", tid)，太容易漏
• 推荐做法：在中间件里基于 http.Request 生成 ID，然后用 req.Context() 存进去，再用 slog.With(slog.String("trace_id", tid)) 创建子 logger
• 或者更轻量：用社区库 github.com/veqryn/slog-context，它提供 slogctx.With，自动从 context 提取并注入
• 注意：With 返回新 Logger，不是修改原 logger，所以中间件里得把新 logger 塞进 context 或传给 handler

要不要用 sloglint 和自定义 linter 规则

不用的话，团队里很快会出现一半 slog.String、一半 "key", value 的混用，!BADKEY 问题反复出现，排查成本飙升。

• 装 sloglint：go install github.com/ettle/strcase/cmd/sloglint@latest
• 加到 CI 或本地 pre-commit：运行 sloglint ./...
• 配置 .sloglintrc 强制 require-typed-attrs: true，禁止裸键值对
• 顺手加 forbidden-keys: ["password", "token"]，防敏感信息误打日志

这些规则看起来琐碎，但一旦上线，就没人敢绕过 —— 比靠 Code Review 记住“别写错”靠谱得多。

终于介绍完啦！小伙伴们，这篇关于《Go语言slog日志使用详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！