Go slog.HandlerOptions 如何给不同 logger 设置独立级别

想让 API 日志只保留 WARN 以上，同时让后台任务保留 DEBUG，不要修改一个全局日志开关。正确做法是为每个 logger 创建独立的 handler，并在各自的 slog.HandlerOptions.Level 中放入自己的级别器。固定阈值用 slog.Level，运行时需要调整则分别使用 *slog.LevelVar。

独立级别的边界在 handler，而不是 logger 名字：两个 logger 只要绑定不同 handler，就能拥有不同的最低日志级别；两个 handler 若共享同一个 LevelVar，级别仍会一起变化。

先分清 logger、handler 与 HandlerOptions 的作用范围

slog.Logger 负责接收 Debug、Info、Warn、Error 等调用，真正决定一条记录是否被处理的是它绑定的 slog.Handler。HandlerOptions.Level 是创建 TextHandler 或 JSONHandler 时使用的过滤条件，不是按 logger 名称自动匹配的配置中心。

因此，API 和 worker 至少要有两个 handler。只创建两个变量但都指向同一个 handler，或者都继续调用顶层 slog.Info，都达不到独立过滤的效果。

用固定 slog.Level 配置两个 logger

固定阈值时，直接把 slog.LevelWarn 或 slog.LevelDebug 放进 Level 即可。下面的两个 handler 即使写向同一个标准输出，过滤边界也仍然各自成立。

package main

import (
    "log/slog"
    "os"
)

func main() {
    // API 通道只保留 Warn 及以上，避免普通请求日志淹没告警。
    apiHandler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
        Level: slog.LevelWarn,
    })
    // 后台任务需要排查细节，所以保留 Debug 及以上。
    workerHandler := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
        Level: slog.LevelDebug,
    })

    apiLogger := slog.New(apiHandler)
    workerLogger := slog.New(workerHandler)

    // 这条被 apiHandler 过滤，workerLogger 的 Debug 不受影响。
    apiLogger.Debug("request details", "route", "/orders")
    apiLogger.Error("request failed", "route", "/orders")
    workerLogger.Debug("job details", "job", "sync")
}

这里的“独立”指过滤器实例独立，不代表输出文件一定要不同。生产环境通常还会让两个 handler 写向不同的 io.Writer，或者由上层采集系统按 JSON 字段分流。

需要热调级别时分别使用 LevelVar

如果级别要由配置、管理接口或临时排障开关调整，使用两个 slog.LevelVar。官方文档把它作为动态 Leveler，调用 Set 后，使用该变量的 handler 会读取新的阈值。

var apiLevel, workerLevel slog.LevelVar

func newLoggers() (*slog.Logger, *slog.Logger) {
    // 每个 LevelVar 只服务一个 handler，避免调试开关互相串线。
    apiLevel.Set(slog.LevelWarn)
    workerLevel.Set(slog.LevelInfo)

    api := slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
        Level: &apiLevel,
    }))
    worker := slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
        Level: &workerLevel,
    }))
    return api, worker
}

func enableWorkerDebug() {
    // 只放宽 worker 通道，API 通道仍保持 Warn 阈值。
    workerLevel.Set(slog.LevelDebug)
}

LevelVar 可以安全地在并发程序中调整，但它不会替你做配置治理：谁可以调用 Set、何时恢复原级别，仍应由应用自己的权限和生命周期控制。

排查独立级别失效的常见写法

还有一个容易忽略的边界：Logger.With 会返回带公共属性的新 logger，但不会复制出新的独立级别。要改变过滤阈值，应创建或包装新的 handler，而不是只给 logger 增加字段。

常见问题

HandlerOptions.Level 不设置时是什么级别？

内置 TextHandler 和 JSONHandler 在 Level 为 nil 时按 slog.LevelInfo 处理，Debug 记录会被过滤。

两个 logger 可以共用一个 handler 吗？

可以，但它们会共享这个 handler 的级别和输出行为；如果目标是独立最低级别，就应创建两个 handler。

LevelVar 和 Level 有什么区别？

slog.Level 是固定值，适合启动时确定的配置；slog.LevelVar 是可动态读取的 Leveler，适合临时排障或运行时配置。