Go slog.NewLogLogger 怎么接入旧日志接口：级别映射、属性保留与迁移边界

线上服务还没准备好一次性改完所有日志调用，旧依赖却已经把 log.Logger 写进了不少接口。Go 1.21 提供的 slog.NewLogLogger 正好解决这段过渡：它返回一个旧式 *log.Logger，每次输出都会交给指定的 slog.Handler，从而让旧调用先接入结构化日志。

先把迁移目标定成一条可验收的链路

这次改造的边界很窄：不动调用方的 logger.Printf，只把它背后的输出目标换成 slog.NewJSONHandler。这样做适合第三方库、历史模块或暂时不能改签名的内部包。验收时不要只看“有日志”，还要确认一条旧调用最终变成一个结构化 Record。

package main

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

func main() {
    handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{})
    legacy := slog.NewLogLogger(handler, slog.LevelInfo)
    legacy.Printf("cache warmed: shard=%s", "shard-2")
}

这段代码的关键不是 Printf 本身，而是输出目标。NewLogLogger 返回的对象仍满足旧代码期望的 *log.Logger，但它的输出会被转换后交给 Handler。终端中应看到 JSON 记录，且至少有时间、级别和消息字段；具体字段名取决于 Handler 配置。

阶段一：在依赖注入处接上桥

先找创建日志器的地方，而不是全仓库替换字符串。常见位置是 NewClient、HTTP Server 初始化或测试夹具。把 *log.Logger 作为旧接口继续传入，内部只改成：

func newLegacyLogger(w io.Writer) *log.Logger {
    h := slog.NewJSONHandler(w, &slog.HandlerOptions{
        Level: slog.LevelInfo,
    })
    return slog.NewLogLogger(h, slog.LevelInfo)
}

这里有两个容易混淆的级别：Handler 的 Level 决定哪些记录被处理；NewLogLogger 的第二个参数决定旧 Logger 输出桥接成什么级别。旧 Logger 没有结构化的逐调用级别，所以不能指望一次 Printf 自动变成 Debug 或 Warn。

阶段二：核对消息、前缀和属性的真实边界

log.Logger 的前缀、日期和文件位置选项仍会影响它交给桥的文本。迁移前如果使用了 log.New(..., "worker ", log.LstdFlags)，不要把旧输出格式当成字段协议；先决定哪些内容应该成为 slog.String 或 slog.Int，再逐步把关键调用改成原生 slog。

建议用一个固定样例验收：输入一条包含 request_id、耗时和结果状态的旧日志，检查 JSON 中是否只是一个完整 message，还是已经有独立字段。NewLogLogger 负责桥接旧 API，不会猜测任意文本中的键值对。

阶段三：决定何时停止使用桥

当新代码需要请求上下文、动态日志级别或明确的结构化属性时，直接注入 *slog.Logger 更合适。例如：

logger.InfoContext(ctx, "cache warmed",
    slog.String("shard", "shard-2"),
    slog.Int("items", 128),
)

一个实用的迁移顺序是：先用桥保持接口稳定；再把高价值路径改成 InfoContext、WarnContext 或 LogAttrs；最后移除只为兼容旧调用而保留的 *log.Logger。这样每一步都有可观察结果，回滚也只需恢复注入点。

常见问题与核对清单

NewLogLogger 能把 Printf 中的键值自动拆成字段吗？

不能把任意文本可靠地推断成字段。它的职责是把旧 Logger 的输出桥接到 Handler；需要稳定字段时，应改用 slog 属性。

为什么设置了 Handler 的 Debug 级别，旧日志仍没有 Debug？

旧 log.Logger 的调用没有逐条级别信息，桥接级别由创建 NewLogLogger 时传入的参数决定。

迁移后 JSON 字段和以前不一样正常吗？

正常。文本日志和结构化 Record 的字段边界不同，应该以检索、告警和下游解析需要为准，保留一组固定样例做回归。

收尾：把桥当作过渡层管理

slog.NewLogLogger 的价值在于降低迁移的瞬时成本：旧接口不用马上重写，输出却可以先进入统一 Handler。真正的结构化收益要靠后续把关键上下文和属性改成原生 slog；每次改动都用同一组 JSON 样例核对级别、消息和字段，别让“日志看起来出来了”代替验收。