Go语言日志过滤实战（使用 log/slog 包实现灵活的日志控制）

什么是日志过滤？

日志过滤指的是：在日志记录过程中，根据某些条件（比如日志级别、特定字段值、运行时状态等）决定是否将某条日志实际写入输出目标（如控制台、文件等）。通过过滤，我们可以避免在生产环境中输出调试（Debug）级别的日志，或者只在特定用户操作时记录详细信息。

slog 中的 LevelHandler 实现日志级别过滤

log/slog 提供了 LevelHandler 类型，允许你设置一个最小日志级别（Level），低于该级别的日志将被自动忽略。这是最常用、最高效的过滤方式。

例如，在生产环境中，我们通常只希望看到 Info 级别及以上的日志（Info、Warn、Error），而 Debug 日志则应被过滤掉。

package mainimport (	"log/slog"	"os")func main() {	// 创建一个只输出 Info 及以上级别日志的处理器	handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{		Level: slog.LevelInfo,	})	logger := slog.New(handler)	// 这条 Debug 日志不会被输出	logger.Debug("调试信息")	// 这条 Info 日志会被输出	logger.Info("应用已启动", "version", "1.0.0")	// Warn 和 Error 也会被输出	logger.Warn("警告：配置未设置")	logger.Error("数据库连接失败")}

运行上述代码，你只会看到 Info、Warn 和 Error 日志，Debug 日志被成功过滤掉了。这就是 Go语言日志过滤 的基础用法。

自定义 Handler 实现高级过滤

除了基于级别的过滤，你还可以通过实现自定义的 slog.Handler 接口，来实现更复杂的过滤逻辑。比如：只记录包含特定字段（如 user_id）的日志，或在特定时间段内关闭日志。

下面是一个简单的自定义 Handler 示例，它会过滤掉所有不包含 env=prod 属性的日志：

package mainimport (	"context"	"log/slog"	"os")// CustomFilterHandler 包装原始 Handler，实现自定义过滤type CustomFilterHandler struct {	slog.Handler}func (h *CustomFilterHandler) Handle(ctx context.Context, r slog.Record) error {	// 检查日志记录中是否包含 env="prod" 的属性	var hasProd bool	r.Attrs(func(a slog.Attr) bool {		if a.Key == "env" && a.Value.String() == "prod" {			hasProd = true			return false // 停止遍历		}		return true	})	// 如果没有 env=prod，则跳过记录	if !hasProd {		return nil	}	// 否则交给原始 Handler 处理	return h.Handler.Handle(ctx, r)}func main() {	baseHandler := slog.NewJSONHandler(os.Stdout, nil)	filterHandler := &CustomFilterHandler{Handler: baseHandler}	logger := slog.New(filterHandler)	// 不会被输出（缺少 env=prod）	logger.Info("普通日志")	// 会被输出	logger.Info("生产环境日志", "env", "prod", "service", "api")}

这种自定义方式虽然灵活，但性能开销略大，建议仅在必要时使用。对于大多数场景，使用 LevelHandler 就足够了。

结合环境变量动态设置日志级别

在实际项目中，我们通常会通过环境变量（如 LOG_LEVEL）来控制日志级别，从而实现不同环境下的 Go slog条件日志 输出。

package mainimport (	"log/slog"	"os"	"strconv")func getLogLevel() slog.Level {	levelStr := os.Getenv("LOG_LEVEL")	if levelStr == "" {		return slog.LevelInfo // 默认 Info	}	// 支持数字（-4 到 12）或字符串（debug/info/warn/error）	if level, err := strconv.Atoi(levelStr); err == nil {		return slog.Level(level)	}	switch levelStr {	case "debug":		return slog.LevelDebug	case "info":		return slog.LevelInfo	case "warn":		return slog.LevelWarn	case "error":		return slog.LevelError	default:		return slog.LevelInfo	}}func main() {	opts := &slog.HandlerOptions{		Level: getLogLevel(),	}	logger := slog.New(slog.NewJSONHandler(os.Stdout, opts))	logger.Debug("调试信息")	logger.Info("常规信息")}

现在你可以通过设置环境变量来控制日志输出：

• LOG_LEVEL=debug go run main.go → 输出 Debug 及以上
• LOG_LEVEL=error go run main.go → 只输出 Error

总结

通过 log/slog 包，Go 开发者可以轻松实现高效、灵活的 Go日志处理。无论是简单的级别过滤，还是复杂的自定义条件，slog 都提供了清晰的接口支持。

记住：合理使用日志过滤不仅能提升系统性能，还能让日志信息更有价值。希望这篇教程能帮助你掌握 slog日志级别 控制和条件日志输出的核心技巧！

关键词回顾：Go语言日志过滤、slog日志级别、Go slog条件日志、Go日志处理。