当前位置：首页 > 文章列表 > Golang > Go教程 > Go slog 如何脱敏嵌套日志：ReplaceAttr、组字段与单元测试

Go slog 如何脱敏嵌套日志：ReplaceAttr、组字段与单元测试

来源：17golang原创 2026-08-09 19:14:24 0浏览收藏

订单服务把请求参数改成结构化日志后，排查问题确实快了，但一条 slog.Info 也可能顺手把 password、token 和手机号写进采集系统。更麻烦的是，敏感字段不一定在最外层，slog.Group("customer", ...) 里的嵌套属性同样需要处理。下面实现一个小型 Go 日志模块：保留业务字段，隐藏敏感值，并用内存缓冲区确认最终 JSON 里没有泄漏。

要点速览

脱敏逻辑放在 HandlerOptions.ReplaceAttr，比调用方逐处记得删字段更稳。
通过 groups 参数判断当前属性所在的嵌套组，避免只检查顶层键名。
对 password、token、手机号采用不同处理：完全隐藏、保留前后缀或只保留末四位。
用 bytes.Buffer 接收 JSON 日志，再断言敏感原文不存在，作为上线前门禁。

先做一个能运行的日志小模块

示例服务只做一件事：记录一笔订单创建事件。项目结构可以保持得很小：

go mod init example.com/slog-redact
touch logger.go logger_test.go

日志调用方不需要知道哪些字段敏感，只负责提供结构化数据。这个边界很重要：业务代码写得越多，越不应该依赖每个开发者都记住脱敏规则。

ReplaceAttr 怎样处理嵌套组字段

ReplaceAttr 会在 Handler 写出属性前收到它。回调参数里的 groups 保存当前属性经过的组名，所以 customer.token 和顶层 token 都能走同一套判断。

ReplaceAttr 遍历 customer 嵌套组并将 token 变成已隐藏值的 Go slog 流程条

package slogredact

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

func redactAttr(groups []string, a slog.Attr) slog.Attr {
    key := strings.ToLower(a.Key)
    switch key {
    case "password", "token", "authorization":
        return slog.String(a.Key, "[hidden]")
    case "phone", "mobile":
        return slog.String(a.Key, maskPhone(a.Value.String()))
    }

    // groups 可用于处理同名字段的特殊规则。
    if len(groups) > 0 && groups[len(groups)-1] == "payment" && key == "card_no" {
        return slog.String(a.Key, "[card-hidden]")
    }
    return a
}

func maskPhone(v string) string {
    if len(v)

上面的完整模块还需要补上 os 导入；为了让测试更容易控制输出，实际项目中我更建议把输出目标作为参数传入，而不是在构造函数里固定标准输出。

把输出目标注入，测试才不会依赖终端

将构造函数改成接收 io.Writer，生产环境传文件或标准输出，测试环境传 bytes.Buffer。这样验收的是 Handler 产生的真实 JSON，而不是只测一个脱敏函数。

package slogredact

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

func NewLogger(w io.Writer) *slog.Logger {
    if w == nil {
        w = os.Stdout
    }
    opts := &slog.HandlerOptions{ReplaceAttr: redactAttr}
    return slog.New(slog.NewJSONHandler(w, opts))
}

调用处只保留业务语义：

logger := NewLogger(os.Stdout)
logger.Info("order.created",
    slog.String("order_id", "O20260721001"),
    slog.Group("customer",
        slog.String("phone", "13800138000"),
        slog.String("token", "bearer-abc-123"),
    ),
    slog.Group("payment",
        slog.String("card_no", "6222021234567890"),
    ),
)

用 bytes.Buffer 核对最终日志

测试不要只断言回调返回了 [hidden]。真正容易出错的是组字段、属性名大小写和 Handler 输出格式，因此直接检查编码后的内容更接近线上结果。

bytes.Buffer 接收 Go JSON 日志并核对 order_id 保留、token 和 card_no 隐藏的验收流程条

package slogredact

import (
    "bytes"
    "strings"
    "testing"
    "log/slog"
)

func TestLoggerRedactsNestedValues(t *testing.T) {
    var buf bytes.Buffer
    logger := NewLogger(&buf)
    logger.Info("order.created",
        slog.String("order_id", "O20260721001"),
        slog.Group("customer", slog.String("token", "bearer-abc-123")),
        slog.Group("payment", slog.String("card_no", "6222021234567890")),
    )

    got := buf.String()
    for _, secret := range []string{"bearer-abc-123", "6222021234567890"} {
        if strings.Contains(got, secret) {
            t.Fatalf("sensitive value leaked: %q", secret)
        }
    }
    for _, marker := range []string{"O20260721001", "[hidden]", "[card-hidden]"} {
        if !strings.Contains(got, marker) {
            t.Fatalf("missing marker %q in %s", marker, got)
        }
    }
}

运行 go test ./... 后，重点看两件事：敏感原文完全不出现，业务定位字段仍然存在。测试通过不代表所有日志调用都安全，所以还应搜索项目里的 slog. 调用，抽样检查异常分支和错误上下文。