安全脱敏必须从反序列化起点拦截，使用mapstructure.decodehookfunc处理敏感字段，显式声明路径、禁用空字符串、各出口独立收口，漏任一环即失效。
配置加载阶段必须用 mapstructure.DecodeHookFunc 拦截
敏感字段（如 password、api_key、secret）一旦被 viper.Unmarshal 写入结构体，就已在内存中明文存在，后续任何“补救”都晚了。真正安全的起点是反序列化过程本身。
- 必须使用
mapstructure.DecodeHookFunc，且只处理f.Kind() == reflect.String && t.Kind() == reflect.String的字段，其他类型跳过，否则会 panic - key 路径要能还原完整嵌套路径（如
"database.credentials.password"），不能只截"password"—— 否则User.Name里含 “pass” 就会被误杀 - 脱敏值禁用空字符串：若字段带
json:",omitempty"，空串会导致字段消失；统一用"[REDACTED]" - 环境变量覆盖时，
viper.AutomaticEnv()会绕过 hook；必须改用viper.BindEnv("database.password", "DATABASE_PASSWORD")，并在绑定前手动对os.Getenv("DATABASE_PASSWORD")做一次脱敏
HTTP 响应脱敏必须替换 http.ResponseWriter
中间件里想在 c.Next() 后读 c.Writer.Body 是徒劳的——Gin/Echo 默认不缓存响应体，WriteHeader 或首次 Write 一调用，字节就推到 TCP 连接，再也拿不到原始 JSON。
- 必须在 handler 执行前替换
c.Writer，实现自定义ResponseWriter，重写Write([]byte)和WriteHeader(int) - 仅对
Content-Type: application/json做处理，text/html、application/octet-stream等直通，避免破坏静态资源或文件下载 - 解析 JSON 时用
json.Decoder.Token()流式匹配 key 路径（如"user.phone"），跳过原值并注入掩码，避免全量Unmarshal带来的内存与 GC 压力 - 别依赖“自动识别字段”，必须显式声明目标路径，或通过 struct tag（如
secure:"phone"）收口控制
结构体序列化脱敏唯一可靠入口是 json.Marshaler
所有对 json.Marshal 返回的 []byte 做字符串替换、正则扫、gzip 解压再改内容的做法，在真实服务中要么漏字段、要么破格式、要么 panic。上线即翻车。
- 必须实现指针接收器：
func (u *User) MarshalJSON() ([]byte, error)；值接收器无法处理u.Profile.Phone或 nil 指针 - 防无限递归：内部定义别名类型
type Alias User，再用(*Alias)(u)转换 - 脱敏值不能为空字符串；若字段带
json:",omitempty"，空值会让字段消失；建议用"*** **** ***"或"[REDACTED]" - 权限判断不能塞进方法签名（
json.Marshal不传context.Context），得靠闭包捕获开关，例如redactEnabled := isRedactEnabled(ctx)后在闭包内使用
日志和 gRPC 等出口必须各自收口，不能共用一套逻辑
一个 log.Printf("%+v", user) 就可能把未脱敏字段全打出来；r.FormValue("token") 直接进日志文件；gRPC 返回、panic 堆栈、甚至 SQL 日志里的参数，都是独立污染源。
- 日志脱敏不能只靠正则全局扫字符串——
138****1234可能被误当成订单号或时间戳；应先识别字段语义（如字段名含phone或值匹配手机号正则），再走预编译规则 - 高频日志场景禁用实时反射；可预生成字段路径缓存（如
"User.Token"→ 对应掩码规则），用sync.Map存储 - gRPC 服务需在
proto层或响应构造层做脱敏，不能依赖拦截器后读 response body——它不提供可读 buffer - 所有出口的脱敏值必须非空、类型一致、契约兼容；
"[REDACTED]"比""更安全，也比"***"更明确
真正难的不是写一个脱敏函数，而是让每条数据流经的每个出口——配置加载、HTTP 响应、日志打印、gRPC 返回、panic 堆栈——都经过同一套可控、可验证、不破坏语义的脱敏路径。漏掉任意一环，前面所有努力都白费。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
