Go slog LevelVar 修改后为什么旧 Handler 也会生效

我在给服务增加调试日志时遇到过一个容易误判的现象：先创建好的 slog.Handler，在后面调用 LevelVar.Set 后，居然也开始输出新的级别。原因不是旧 Handler 被偷偷重建，而是它的 HandlerOptions.Level 保存了 Leveler，传入的 *slog.LevelVar 仍然是同一个动态对象。

要让已经创建的 Handler 动态响应级别变化，应把同一个 *slog.LevelVar 传给 HandlerOptions.Level。如果先调用 level.Level() 再传入结果，得到的就是静态快照，后续 Set 不会影响那个 Handler。

官方资料：https://pkg.go.dev/log/slog

Handler 保存的是 Leveler，不是创建时的级别

HandlerOptions.Level 的类型是 slog.Leveler。普通的 slog.Level 是固定实现；*slog.LevelVar 则会在每次调用 Level() 时返回当前值。内置 TextHandler 和 JSONHandler 在判断一条记录是否启用时会读取这个接口，所以旧 Handler 也会受到同一个 LevelVar 的变化影响。

零值 LevelVar 对应 Info，并且它被设计为可被多个 goroutine 读取和写入。这里的“动态”只描述最低日志级别，不会更换 Handler 的输出目标、格式化方式或已经绑定的属性。

正确写法：把 LevelVar 指针交给 Handler

运行时配置通常只需要保留一个级别变量。下面的示例先让 Handler 默认输出 Info，再通过同一个指针切换到 Debug；两个 Logger 都共享这个 Handler，因此无需重新创建 Logger。

package main

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

func main() {
    var level slog.LevelVar // 零值为 Info，指针会被 Handler 长期保存
    handler := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
        Level: &level, // 传入 Leveler，Handler 每次判断时都会读当前值
    })
    logger := slog.New(handler)
    logger.Debug("debug-before") // Info 阈值下不会输出

    level.Set(slog.LevelDebug) // 修改共享配置，不需要替换 handler
    logger.Debug("debug-after") // 同一个旧 Handler 现在允许 Debug

    _ = logger.Enabled(context.Background(), slog.LevelDebug) // 可直接观察当前阈值
}

在服务里把 level 放进配置对象也可以，但不要复制一个已经使用过的 LevelVar。需要共享的是指针，配置热更新函数只负责调用 Set。

最常见的误区是把动态值提前拍成快照

下面两种初始化看起来相似，行为却不同。第一种保留了 Leveler 关系；第二种先取出一个 slog.Level，Handler 后续只能看到初始化时的值。

var dynamic slog.LevelVar
dynamic.Set(slog.LevelWarn)

live := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
    Level: &dynamic, // 动态：之后 Set 会影响这个 Handler
})
snapshot := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
    Level: dynamic.Level(), // 静态：只复制当前的 WARN 数值
})

dynamic.Set(slog.LevelDebug)
_ = live.Enabled(context.Background(), slog.LevelDebug)     // true
_ = snapshot.Enabled(context.Background(), slog.LevelDebug) // false

所以看到“新级别生效”时，先确认代码传进去的是 &level 还是 level.Level()。后者不是 bug，而是明确选择了静态配置。

旧 Logger、With 派生对象和并发修改怎么判断

logger.With(...) 返回的新 Logger 会基于原 Handler 派生属性；只要底层 Handler 仍引用同一个 LevelVar，原 Logger 和派生 Logger 都会看到级别变化。调用 slog.SetDefault 只是更换默认 Logger，不会改变已经创建的自定义 Handler。

LevelVar 的读写本身支持并发，但“支持并发”不等于配置更新和业务日志之间存在一个业务事务。若调试开关需要审计，可以在调用 Set 的位置记录旧值、新值和操作者；不要用日志是否出现来反推更新是否完成。

用 Enabled 测试锁住这个边界

与其依赖 stdout 的文本，更适合直接测试 Handler 的 Enabled 结果。测试一个动态 Handler 和一个快照 Handler，就能把“共享 LevelVar”和“复制当前 Level”区分开。

func TestLevelVarAffectsExistingHandler(t *testing.T) {
    var level slog.LevelVar
    live := slog.NewTextHandler(io.Discard, &slog.HandlerOptions{Level: &level})
    fixed := slog.NewTextHandler(io.Discard, &slog.HandlerOptions{Level: level.Level()})

    level.Set(slog.LevelDebug) // 只更新共享 LevelVar
    if !live.Enabled(context.Background(), slog.LevelDebug) {
        t.Fatal("live handler did not observe LevelVar")
    }
    if fixed.Enabled(context.Background(), slog.LevelDebug) {
        t.Fatal("snapshot handler unexpectedly changed")
    }
}

这个测试中的 io.Discard 只是不让测试输出污染日志；它不改变级别判断。若线上仍然看不到 Debug，再检查实际使用的 Logger 是否指向另一个 Handler、是否有更高一层的过滤器，以及配置更新是否写入了另一份 LevelVar。

相关问题与处理结论

修改 LevelVar 后为什么不用重新创建 Handler？

因为内置 Handler 保存的是 Leveler，处理记录时会读取 Level()。只要传入的是同一个指针，旧 Handler 就能看到新级别。

什么时候应该重新创建 Handler？

需要更换输出目标、编码格式、ReplaceAttr 或固定属性时再重建；单独切换最低级别用 LevelVar.Set 更直接。

LevelVar 可以复制到另一个配置结构吗？

不要复制已经使用过的 LevelVar。保留一个指针并让各处引用它，既符合其原子读写设计，也能避免不同副本各自变化。

排查这类现象时，先画出“哪个 Handler 引用了哪个 Leveler”，再检查是否有人把动态值拍成了 slog.Level。只要引用关系明确，旧 Handler 会生效反而是预期行为。