Go语言脱敏应基于类型内聚：为Phone、IDCard等定义专属类型并实现String()或Mask()，通过json.Marshaler自动序列化脱敏，校验后再掩码，避免通用函数和正则滥用。

Go 语言没有内置脱敏能力，但用标准库就能实现轻量、可控、可复用的脱敏模块。

关键不是“封装成多大一个包”，而是把脱敏逻辑和原始数据解耦。

让 Phone、IDCard、Email 这类字段自己知道怎么藏住敏感部分。

脱敏逻辑必须绑定到具体字段类型，而不是写一堆 if-else

常见错误是写一个通用函数 Mask(value string, rule string)，然后在业务层传入规则字符串。

这会导致规则散落、无法静态检查、易错且难测试。

正确做法是为每种敏感类型定义专属结构体，把脱敏行为内聚进去。

• type Phone string 实现 String() 方法，返回掩码后结果（如 138****1234）
• type IDCard string 实现 Mask() 方法，只暴露前6位+后4位（110101********1234）
• 所有方法不修改原始值，保持不可变语义
• 避免在结构体里存 masked 字段——脱敏是视图行为，不是数据状态

JSON 序列化时自动脱敏，别靠中间件或手动调用

业务在返回 HTTP 响应时，常常会遇到这样的需求：某些字段需要脱敏，其他字段则保持原样。

要是依赖 json.Marshal 之后再做字符串替换，或者在 handler 里逐个调用 phone.Mask()，一旦字段新增了、结构变复杂了，遗漏几乎是迟早的事。

相比之下，Go 的 json.Marshaler 接口，才是更稳妥的做法。

• 让 Phone 实现 MarshalJSON() ([]byte, error)，返回已脱敏的 JSON 字符串字面量
• 注意：返回值必须是合法 JSON 字符串（带双引号），所以得用 json.Marshal(fmt.Sprintf("138****%s", p[7:])) 或手动拼接加转义
• 若需开关脱敏（如内部调试接口），可用包装类型 type SafePhone struct{ Raw Phone; Debug bool }，在 MarshalJSON 中分支处理
• 别在 UnmarshalJSON 做脱敏——那是解析，不是展示

正则不是万能的，身份证/手机号要按格式校验后再脱敏

直接对任意字符串做 regexp.ReplaceAllString 掩码，会把非合规数据也“伪脱敏”，掩盖真实问题。

比如把 "abc123" 脱成 "ab****3"，看起来像掩码成功，实则字段根本无效。

• 脱敏前先校验：用 regexp.MustCompile(`^1[3-9]d{9}$`) 判手机号，用 verifyIDCard(string) 校验身份证末位
• 校验失败时，返回原值 or panic（开发期）or 日志告警（生产期），而非强行掩码
• 正则捕获组比全局替换更安全：re := regexp.MustCompile(`^(1[3-9]d{2})d{4}(d{4})$`)，再用 re.ReplaceAllStringFunc(s, "$1****$2")
• 注意中文字符、全角数字、空格等干扰项——输入清洗应在脱敏之前完成

真正棘手的，从来不是多写几个掩码函数，而是先把两件事想清楚：

到底谁应该有权限看到明文；脱敏之后，会不会连带影响下游的签名、索引这类逻辑。

举个很典型的场景，日志里的手机号已经做了脱敏，但审计系统做关联时偏偏又要依赖原始值，这种情况下，正确做法是通过上下文把原始值传递下去，而不是再从脱敏字段里倒推出原值。

说到底，脱敏模块做得越“透明”，被误用的风险往往也越高。

《夸克》非常好用的免费AI浏览器

下载APP查看