在go-zero框架中实现日志脱敏,核心做法是自定义一个实现了 zapcore.core 接口的包装器,在数据写入前对日志字段进行正则替换。具体操作是将全局日志配置中的 core 选项指向这个自定义组件,这样所有通过 logx 输出的信息都会经过过滤,将手机号、身份证等敏感数据自动替换为掩码字符。

如何编写通用的日志脱敏Core组件?
直接回答:需要创建一个结构体实现 zapcore.Core 接口,并在 Check 和 Add 方法中拦截日志条目。通过遍历 Entry.Fields,使用预编译的正则表达式匹配敏感模式(如手机号),并将匹配到的值替换为脱敏后的字符串,最后调用底层 Core 输出。

package logx
import (
"regexp"
"strings"
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
)
// SensitiveCore 包装 zapcore.Core,实现日志脱敏
type SensitiveCore struct {
core zapcore.Core
regexs []*regexp.Regexp
}
// NewSensitiveCore 创建带脱敏功能的 Core
func NewSensitiveCore(core zapcore.Core, patterns []string) *SensitiveCore {
var regexs []*regexp.Regexp
for _, p := range patterns {
if r, err := regexp.Compile(p); err == nil {
regexs = append(regexs, r)
}
}
return &SensitiveCore{core: core, regexs: regexs}
}
// Enabled 判断是否启用
func (sc *SensitiveCore) Enabled(level zapcore.Level) bool {
return sc.core.Enabled(level)
}
// With 添加字段
func (sc *SensitiveCore) With(fields []zapcore.Field) zapcore.Core {
return &SensitiveCore{
core: sc.core.With(fields),
regexs: sc.regexs,
}
}
// Check 检查级别
func (sc *SensitiveCore) Check(entry zapcore.Entry, ce *zapcore.CheckedEntry) *zapcore.CheckedEntry {
if sc.Enabled(entry.Level) {
return ce.AddCore(entry, sc)
}
return ce
}
// Add 添加日志并脱敏
func (sc *SensitiveCore) Add(entry zapcore.Entry, fields []zapcore.Field) error {
// 对字段值进行脱敏处理
cleanedFields := make([]zapcore.Field, 0, len(fields))
for _, f := range fields {
cleanedFields = append(cleanedFields, sanitizeField(f, sc.regexs))
}
return sc.core.Add(entry, cleanedFields)
}
// sanitizeField 递归清理字段值
func sanitizeField(f zapcore.Field, regexs []*regexp.Regexp) zapcore.Field {
switch f.Type {
case zapcore.StringType:
f.Value = sanitizeString(f.String, regexs)
case zapcore.ArrayMarshalerType:
// 简化处理:仅处理顶层字符串,复杂结构需递归
f.Value = sanitizeString(f.String, regexs)
default:
// 其他类型暂不处理或转为字符串处理
f.Value = sanitizeString(fmt.Sprintf("%v", f.Interface), regexs)
}
return f
}
// sanitizeString 执行正则替换
func sanitizeString(s string, regexs []*regexp.Regexp) string {
result := s
for _, r := range regexs {
result = r.ReplaceAllStringFunc(result, func(match string) string {
// 保留前3后4位,中间用*代替
if len(match) > 7 {
return match[:3] + strings.Repeat("*", len(match)-7) + match[len(match)-4:]
}
return strings.Repeat("*", len(match))
})
}
return result
}
上述代码定义了 SensitiveCore,它接收原始 zapcore.Core 和一组正则表达式。在 Add 方法中,遍历所有字段,调用 sanitizeField 对字符串类型的值进行正则匹配替换。例如,对于手机号 13812345678,会被替换为 138*****5678。使用时只需在初始化日志时传入该 Core 即可。
如何在Go-Zero配置文件中集成脱敏逻辑?
直接回答:需要在 service.yaml 中配置日志的 Mode 和 Encoder,并通过代码初始化时将自定义的 SensitiveCore 注入到 logx 的全局实例中。通常建议在 main.go 启动阶段完成这一替换,确保后续所有日志输出都经过脱敏。

package main
import (
"fmt"
"regexp"
"github.com/zeromicro/go-zero/core/logx"
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
)
// 定义敏感信息正则
var phoneRegex = regexp.MustCompile(`1[3-9]\d{9}`)
var idCardRegex = regexp.MustCompile(`\d{17}[\dXx]`)
func main() {
// 1. 初始化基础日志配置
config := logx.LogConfig{
Mode: "console",
Encoding:











