Golang设置slog日志级别方法

Go 1.21+ 引入的 `slog` 包将日志级别控制与格式化彻底解耦，其默认仅输出 `Info` 及以上级别日志，导致 `Debug` 日志被静默过滤而非报错或失效；要启用 DEBUG 日志，必须显式配置 `HandlerOptions.Level` 为 `slog.LevelDebug`（开发常用）或动态使用 `slog.LevelVar` 实现运行时热更新，同时务必通过 `slog.SetDefault()` 生效——而最容易踩坑的是：漏设 `SetDefault`、误用 `nil` 选项、混淆不同 `Logger` 实例的独立级别设置，以及在 HTTP 上下文或中间件中忽略 `ctx` 状态和 handler 绑定关系，再加上开发与生产环境在 `AddSource`、输出目标和级别策略上的差异，稍有不慎就导致 DEBUG 日志“神秘消失”。

为什么 slog 默认不输出 DEBUG 日志

slog 默认日志级别是 slog.LevelInfo，这意味着所有 slog.Debug()、slog.DebugContext() 调用都会被静默丢弃——不是报错，也不是没生效，而是压根不进 Handler。这是设计使然，不是 bug，也不是配置遗漏。

• Go 1.21+ 的 slog 把“是否记录”和“如何格式化输出”彻底分离：级别控制在 HandlerOptions.Level，输出格式由 Handler 决定
• 直接调用 slog.Debug("...") 却看不到日志？先检查 slog.SetDefault() 是否用了带 Level: slog.LevelDebug 的 handler
• 别试图用 log.SetFlags() 或改全局 log 包来影响 slog——两者完全无关

怎么设置 slog 全局最低输出级别

核心就一句：slog.SetDefault(slog.New(handler))，而 handler 必须显式传入带级别控制的 HandlerOptions。

• 开发环境常用：&slog.HandlerOptions{Level: slog.LevelDebug}
• 生产环境推荐：&slog.HandlerOptions{Level: slog.LevelInfo}（避免高频 debug 拖慢 IO）
• 想运行时热更新？用 slog.LevelVar：

  var level = slog.LevelVar{} // 初始化为 Info
  handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: &level})
  slog.SetDefault(slog.New(handler))
  // 后续可随时 level.Set(slog.LevelDebug)

• 注意：Level 是“最低接受级别”，Debug 级别最低（数值最小），Error 最高（数值最大）

DEBUG 日志不显示？检查这三处硬性条件

slog.Debug() 要真正输出，必须同时满足：Logger 实例启用了 Debug 级别 + 当前 handler 支持该级别 + 调用时上下文未被提前 cancel 或超时。

• 错误写法：slog.New(slog.NewTextHandler(os.Stdout, nil)) —— nil 意味着用默认 HandlerOptions，即 LevelInfo，Debug 被过滤
• 漏掉 slog.SetDefault()：即使你 new 了一个 debug 级别的 logger，没 setdefault，slog.Debug() 仍走默认（info 级）实例
• HTTP 中间件里用 slog.DebugContext(ctx, ...) 却无输出？确认 ctx 没被 cancel，且 handler 的 Level 设置生效于该 logger 实例（不是另一个副本）

环境差异导致的级别陷阱

开发时看到 DEBUG 日志，上线后全没了？大概率是环境变量没透传，或 JSON/Text handler 的 AddSource 和 Level 混在一起配错了。

• 开发用 slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug, AddSource: true}) —— AddSource 开启会暴露文件行号，生产必须关
• 生产用 slog.NewJSONHandler(os.Stderr, &slog.HandlerOptions{Level: slog.LevelInfo, AddSource: false}) —— 不仅级别降了，AddSource 关闭还能省 10%+ CPU
• 别靠 os.Getenv("ENV") == "dev" 手动分支构造 handler；统一用 slog.LevelVar + 配置中心或信号监听，避免重启才能切级别

实际项目里最容易被忽略的，是「同一个服务里多个 slog.Logger 实例各自有独立 Level 控制」——中间件用的 logger、DB 层用的 logger、HTTP handler 用的 logger，可能根本不是同一个实例。级别设对了 default，不代表所有地方都生效。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang设置slog日志级别方法》文章吧，也可关注golang学习网公众号了解相关技术文章。