Go slog.LevelVar 怎么运行时调整日志级别

Go 的 log/slog 可以在程序运行期间切换最低日志级别，关键是把 HandlerOptions.Level 设置为同一个 *slog.LevelVar。调整时调用 Set，不需要重建 Logger 或替换 handler；之后的新日志记录会按照新的阈值判断。

官方文档：https://pkg.go.dev/log/slog

最小实现是声明一个默认为 Info 的 slog.LevelVar，创建 handler 时把它交给 Level，配置刷新时调用 level.Set(slog.LevelDebug)。LevelVar 适合多个 goroutine 读取和写入，但它只控制日志是否达到最低级别，不负责远程配置、权限校验或业务字段脱敏。

先把可变级别接入 Handler

slog.LevelVar 保存一个 slog.Level，零值按 Info 级别使用。把它作为指针传给 HandlerOptions.Level 后，内置的文本或 JSON handler 会在处理日志时读取当前值。Logger 仍然可以长期复用，这正是运行时切换不需要重建日志链路的原因。

package main

import (
	"log/slog"
	"os"
)

func main() {
	// LevelVar 的零值是 Info，作为整个进程共享的最低日志级别。
	var programLevel slog.LevelVar

	// Handler 每次判断日志是否启用时都会读取 programLevel 的当前值。
	handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
		Level: &programLevel,
	})
	logger := slog.New(handler)

	logger.Debug("启动调试信息") // 默认 Info 阈值下不会输出。
	logger.Info("服务启动", "port", 8080)

	// 配置刷新后只改变阈值，不需要重建 handler 或 logger。
	programLevel.Set(slog.LevelDebug)
	logger.Debug("调试级别已打开")
}

这里的 Set 只影响调用发生之后的级别判断。切换前已经被 handler 丢弃的 Debug 记录不会补写，切换前已经输出的 Info 记录也不会被修改。若使用多个 handler，只有引用这个 LevelVar 的 handler 会跟随它变化。

把 Set 放在可审计的配置刷新入口

实际项目通常从环境变量、配置文件、管理接口或信号处理函数得到新级别。不要让业务函数到处直接调用 Set，可以集中成一个更新函数：先把字符串解析成允许的级别，再记录变更来源，最后原子地更新阈值。LevelVar.Set 只接受已经得到的 slog.Level，不会替你校验调用方权限。

func updateLogLevel(logger *slog.Logger, levelVar *slog.LevelVar, text string) error {
	var next slog.Level
	// UnmarshalText 支持 debug、info、warn、error 等文本级别。
	if err := next.UnmarshalText([]byte(text)); err != nil {
		return err // 无效配置不应改变当前有效阈值。
	}

	levelVar.Set(next)
	// 变更日志使用 Info，避免打开 Debug 后产生不可控的反馈噪声。
	logger.Info("日志级别已更新", "level", next.String())
	return nil
}

配置服务还应决定重启后是否恢复新值，并限制可用级别范围。例如生产环境可以允许临时打开 Debug，但要求带操作者、原因和过期时间；这些是应用治理问题，不是 LevelVar 的 API 能力。

并发切换、昂贵参数与多 Handler 边界

官方定义的 LevelVar 可以被多个 goroutine 安全读取或写入，因此配置刷新 goroutine 调用 Set 时，日志 goroutine 不需要额外给它加锁。读取当前值可调用 Level，但不要把一次读取结果当成跨多个日志调用的事务状态：另一个 goroutine 可能在两次调用之间更新级别。

还要区分“日志被启用”和“日志参数已经计算”。下面的 Enabled 检查可以避免在 Debug 被关闭时生成大对象；只写成 logger.Debug("统计", "value", buildReport())，buildReport 仍会先执行。

func logReport(ctx context.Context, logger *slog.Logger) {
	// Enabled 只检查当前 handler 的阈值，先判断再构造昂贵结果。
	if !logger.Enabled(ctx, slog.LevelDebug) {
		return
	}
	report := buildReport() // 只有 Debug 日志真正启用时才计算。
	logger.DebugContext(ctx, "生成调试报告", "report", report)
}

常见问题：运行时调整级别的几个误区

调用 Set 后为什么旧日志没有补出来？

handler 只在日志调用到达时判断级别。之前被过滤掉的记录没有缓存，所以 Set 不会回放历史日志。

LevelVar 能不能让不同模块使用不同日志级别？

可以，但要按模块创建不同的 LevelVar 和 handler，或在模块层自行做 Enabled 判断。多个 handler 共享同一个 LevelVar 时，它们会一起看到同一阈值变化。

把 LevelVar 放进配置接口就安全吗？

不自动安全。接口仍需身份校验、级别白名单、变更审计和自动恢复策略；LevelVar 只解决进程内的并发读写和阈值读取。

因此，Go slog.LevelVar 的核心用法可以浓缩为“handler 绑定一次，配置变化时调用 Set”。把更新入口集中起来，再用 Enabled 处理昂贵参数，并为不同输出链路明确共享范围，就能在不重建 Logger 的前提下获得可控的运行时日志级别切换。