Go log/slog.HandlerOptions 如何统一日志级别：LevelVar、ReplaceAttr 与运行时切换

线上服务最怕的不是日志少，而是调试时临时打开一堆细节，结果没人知道哪些级别已经生效。log/slog 把这件事拆成了几个清楚的职责：HandlerOptions.Level 决定门槛，LevelVar 负责运行时改门槛，ReplaceAttr 则整理输出字段。

把 LevelVar 放进 HandlerOptions.Level，就能在不重建 Logger 的情况下切换日志级别；字段脱敏和统一命名再交给 ReplaceAttr。

先把三层职责摆在同一条链上

一条实际的调用链是：业务调用 slog.Debug，Logger 生成 Record，再交给 Handler；Handler 先依据 HandlerOptions.Level 判断是否启用，真正输出前才经过 ReplaceAttr。所以“日志没出现”和“字段被改写”是两类问题。

var logLevel slog.LevelVar
logLevel.Set(slog.LevelInfo)

handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
    Level:       &logLevel,
    AddSource:   true,
    ReplaceAttr: redactAttr,
})
logger := slog.New(handler)
logger.Debug("cache probe", "cache_key", "user:42")
logger.Info("request finished", "status", 200)

这里 LevelVar 的初始值是 Info，所以第一条 Debug 不会进入 Handler 的输出路径，第二条 Info 会被保留。AddSource 和 ReplaceAttr 只影响已经进入处理流程的记录。

用 LevelVar 做一次可回滚的运行时切换

把级别变量单独保存，配置中心或管理命令只需要调用 Set。切换动作应该有明确的旧值、新值和回滚值，避免排障结束后长期保留 Debug 噪声。

func setDebug(enabled bool) {
    if enabled {
        logLevel.Set(slog.LevelDebug)
        return
    }
    logLevel.Set(slog.LevelInfo)
}

这段代码没有重建 Handler，也没有替换全局 Logger。切到 Debug 后再次调用 slog.Debug，该记录就能通过同一个 Handler；切回 Info 后，Debug 又被门槛挡住。并发服务里，切换入口仍要做权限校验和审计记录。

让 ReplaceAttr 只做字段整理

ReplaceAttr 收到的是当前分组路径和属性，可以用来把时间字段改成固定键名，也可以对业务属性做脱敏。它不应承担“关闭 Debug”这种级别决策，否则同一条记录的输出与否会变得难以推断。

func redactAttr(groups []string, attr slog.Attr) slog.Attr {
    if attr.Key == "cache_key" {
        return slog.String("cache_key", "[redacted]")
    }
    if attr.Key == slog.TimeKey {
        return slog.String("logged_at", attr.Value.Time().UTC().Format(time.RFC3339))
    }
    return attr
}

输出里应该看到 logged_at 和 [redacted]，而不是原始的 cache_key 值。若日志完全没有出现，先查 LevelVar 当前级别，不要从 ReplaceAttr 里猜原因。

最小验收：分别验证门槛和字段

1. 初始级别设为 Info，确认 Info 记录出现、Debug 记录不出现。
2. 调用 LevelVar.Set(slog.LevelDebug)，再次写 Debug，确认同一 Logger 输出它。
3. 切回 Info，确认 Debug 再次被过滤，避免配置只升不降。
4. 检查 JSON 中是否有 logged_at，且 cache_key 已变为 [redacted]。
5. 给切换入口补充权限、审计和失败回滚记录。

相关问题

改 LevelVar 后需要重新创建 Logger 吗？

不需要。只要 HandlerOptions.Level 保存的是这个 LevelVar，后续记录会读取它的当前级别。

ReplaceAttr 能过滤 Debug 日志吗？

不建议。日志级别过滤属于 Handler 的门槛，ReplaceAttr 更适合字段改名、脱敏和格式整理。

为什么切到 Debug 仍看不到日志？

先确认调用的是同一个 Logger 或默认 Logger，再检查 Handler 是否绑定了目标 LevelVar，以及输出目标是否被外层采集规则过滤。

总结

HandlerOptions.Level 管“放不放行”，LevelVar 管“什么时候调整门槛”，ReplaceAttr 管“放行后长什么样”。把三件事分开，运行时排障就能用一条可验证的链路定位问题，也能在排障结束后安全恢复到 Info。