当前位置：首页 > 文章列表 > Golang > Go问答 > Go slog.JSONHandler ReplaceAttr 如何隐藏敏感字段：属性改写与分组边界

Go slog.JSONHandler ReplaceAttr 如何隐藏敏感字段：属性改写与分组边界

来源：17golang原创 2026-08-28 05:24:16 0浏览收藏

线上日志接入 slog.NewJSONHandler 后，最容易被忽略的风险不是 JSON 格式，而是把 password、token 之类的字段原样写进了日志。HandlerOptions.ReplaceAttr 可以在序列化前统一改写或丢弃属性，但它对分组属性的调用方式有明确边界：回调拿到的是当前属性和已经打开的 groups，不是整个 Group 节点。

要点速览

ReplaceAttr 只处理非分组 Attr，分组名称通过 groups 参数传入。
返回零值 Attr{} 会从输出中删除当前字段，适合做敏感字段过滤。
JSON 输出保留组层级，文本输出会把组名拼到键上，不能只按最终字符串猜路径。
先匹配 groups 再匹配键名，能避免不同业务分组中的同名字段被误删。

一次真实故障：密码字段为什么仍出现在 JSON 日志里

假设业务代码把认证信息放在 request 组中：

logger.LogAttrs(ctx, slog.LevelInfo, "login",
    slog.Group("request",
        slog.String("user", "alice"),
        slog.String("password", "secret"),
    ),
)

如果过滤器只判断 a.Key == "password"，看起来应该能命中；但当代码同时处理多种嵌套结构时，真正需要确认的还有这个属性当前处在哪个组里。更糟的是，有人把 Group 当成普通属性处理，试图在遇到组节点时直接改写，结果过滤逻辑根本没有按预期执行。

Go slog.JSONHandler 调用 ReplaceAttr 时 groups 传入当前分组、Attr 承载具体字段的调用链示意图

从 handler.go 看清 ReplaceAttr 的调用时机

Go 官方 log/slog 源码把行为拆成两步。首先，appendAttr 会让属性值执行 Resolve；随后，当值不是 KindGroup 时才调用 ReplaceAttr。所以回调接收的是已经解析过的具体 Attr，不会直接收到整个 Group 属性。

opts := &slog.HandlerOptions{
    ReplaceAttr: func(groups []string, a slog.Attr) slog.Attr {
        if len(groups) == 1 && groups[0] == "request" && a.Key == "password" {
            return slog.Attr{}
        }
        return a
    },
}

logger := slog.New(slog.NewJSONHandler(os.Stdout, opts))

这里的判断顺序很重要：先检查 groups，再检查 a.Key。返回 slog.Attr{} 是零值 Attr，内置 handler 会把它视为待丢弃字段；返回原来的 a 则继续序列化。

官方源码给出的调用示例也说明了这一点：普通字段的 groups 为 nil，而 Group("g", Int("b", 2)) 中的 b 会以 []string{"g"} 传入。

分组嵌套时，过滤规则应该怎样写

如果日志里还有 response 组，同名的 token 可能并不敏感，或者需要不同的脱敏方式。可以把分组路径拼成自己的判断条件，但不要修改 groups 切片，它由 handler 管理，官方文档明确要求回调不要保留或修改它。

func redact(groups []string, a slog.Attr) slog.Attr {
    if a.Key != "password" && a.Key != "token" {
        return a
    }
    if len(groups) == 1 && groups[0] == "request" {
        return slog.String(a.Key, "[REDACTED]")
    }
    return a
}

这个版本不删除字段，而是保留键名并替换值，便于排查日志结构。若合规要求连字段名也不能出现，才返回零值 Attr。要注意，回调只会收到叶子属性；如果组里嵌套了另一个组，groups 会按打开顺序包含多个名称。