掌握Go语言中的上下文日志（使用log/slog包实现高效结构化日志记录）

准备工作：启用 slog

首先确保你使用的是 Go 1.21 或更高版本。然后在代码中导入 log/slog 包：

package mainimport (	"context"	"log/slog"	"os")

基础用法：创建带上下文的日志记录器

我们可以使用 slog.With() 方法向日志记录器添加固定字段，但要实现真正的上下文日志，需要结合 context.Context。为此，slog 提供了 slog.SetDefault() 和 slog.Handler 的扩展能力。

不过更推荐的方式是使用第三方库（如 github.com/lmittmann/tint）或自定义 Handler 来支持上下文。但在标准库中，我们可以通过将日志记录器存储在 Context 中来实现类似效果。

实战：在 HTTP 请求中使用上下文日志

下面是一个完整的例子，展示如何在 Web 服务中为每个请求生成唯一 ID，并将其自动附加到所有日志中。

package mainimport (	"context"	"crypto/rand"	"encoding/hex"	"log/slog"	"net/http"	"os")// 定义一个 key 类型，用于在 context 中存储 loggertype ctxKey intconst loggerKey ctxKey = iota// 生成唯一请求 IDfunc generateRequestID() string {	bytes := make([]byte, 8)	rand.Read(bytes)	return hex.EncodeToString(bytes)}// 中间件：为每个请求创建带 request_id 的 loggerfunc loggingMiddleware(next http.Handler) http.Handler {	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {		requestID := generateRequestID()		// 创建带 request_id 字段的新 logger		logger := slog.With("request_id", requestID)		// 将 logger 存入 context		ctx := context.WithValue(r.Context(), loggerKey, logger)		// 使用新 context		next.ServeHTTP(w, r.WithContext(ctx))	})}// 从 context 中获取 logger 的辅助函数func getLogger(ctx context.Context) *slog.Logger {	if logger, ok := ctx.Value(loggerKey).(*slog.Logger); ok {		return logger	}	// 如果没有找到，返回默认 logger	return slog.Default()}func handler(w http.ResponseWriter, r *http.Request) {	logger := getLogger(r.Context())	// 记录日志，自动包含 request_id	logger.Info("处理用户请求", "user", "alice", "action", "login")	w.Write([]byte("Hello from Go slog!"))}func main() {	// 设置默认日志格式为 JSON（可选）	slog.SetDefault(slog.New(slog.NewJSONHandler(os.Stdout, nil)))	http.Handle("/", loggingMiddleware(http.HandlerFunc(handler)))	slog.Info("服务器启动", "port", 8080)	http.ListenAndServe(":8080", nil)}

运行上述代码后，每次访问 http://localhost:8080，你都会看到类似如下的日志输出（JSON 格式）：

{  "time": "2024-06-01T10:20:30.123456789Z",  "level": "INFO",  "msg": "处理用户请求",  "request_id": "a1b2c3d4e5f6g7h8",  "user": "alice",  "action": "login"}

可以看到，request_id 被自动附加到每条日志中，无需在每次调用 logger.Info() 时重复传入。这就是 Go上下文日志记录 的强大之处。

进阶技巧：自定义 Handler 支持全局上下文

如果你希望更深入集成，可以实现自己的 slog.Handler，使其在记录日志时自动从 context.Context 中提取字段。虽然标准库目前不直接支持“全局上下文日志”，但社区已有成熟方案（如 golang.org/x/exp/slog 的早期实验版本曾尝试此功能）。

不过对于大多数应用场景，上述中间件+Context 存储 Logger 的方式已经足够高效且清晰。

总结

通过本文，你学会了如何在 Go 语言中使用 log/slog 包实现 Go结构化日志 与上下文日志记录。关键点包括：

• 使用 slog.With() 添加固定字段
• 通过 context.Context 传递带有上下文信息的 logger
• 在 HTTP 中间件中为每个请求注入唯一标识
• 避免在业务逻辑中重复传入上下文字段

掌握 Go slog日志包 的上下文日志功能，将极大提升你构建可观测性系统的效率。赶快在你的项目中试试吧！