不该在 handler 里用反射做实时脱敏，因 reflect.valueof 遍历结构体导致性能下降超 10 倍；应改用 go:generate 生成专用方法或初始化阶段缓存反射信息，配合 redact tag 声明脱敏策略。
为什么不该在 handler 里用反射做实时脱敏
高频接口中每次请求都用 reflect.ValueOf 遍历结构体字段，性能会掉 10 倍以上——不是夸张，是实测。Go 反射开销大、无法内联、GC 压力陡增，尤其当结构体嵌套深或字段多时，CanInterface() 判断、Elem() 解指针、Interface() 转 interface{} 这几步全在热路径上。
常见错误是写个通用 Redact(v interface{}) 函数，丢进 Gin 中间件里调用。结果压测一跑，CPU 火焰图里 reflect.Value.Interface 占满半屏。
- 真正可行的路只有一条：用
go:generate为常用结构体生成专用Redact()方法，零反射、零运行时开销 - 若必须动态（比如配置驱动的脱敏字段），至少把反射逻辑移到初始化阶段，缓存
reflect.Type和字段偏移，运行时只做unsafe.Pointer偏移访问 - 别碰私有字段：
CanInterface() == false的字段直接跳过，强行取值会 panic，且违反封装契约
struct tag 是唯一靠谱的脱敏声明方式
用 json: tag 复用做脱敏开关是错的——标准库会忽略它，你的反射逻辑却得自己解析，还容易和序列化语义冲突。正确做法是定义专属 tag，比如 redact:"true,mask=phone" 或 secure:"id_card,rule=china_id"。
这种声明方式编译期可校验、IDE 能跳转、无 magic 字符串，上线前还能用 go vet 插件检查是否漏标敏感字段。
- 解析时用
structTag.Get("redact")，再按逗号分段提取参数，避免正则或复杂 parser - 遇到
Kind() == reflect.Ptr必须先Elem()；遇到Kind() == reflect.Interface要Interface()后再判断真实类型 - 别让
json:",omitempty"和脱敏打架：脱敏后字段变空字符串，omitempty会让它消失。要么去掉该 tag，要么脱敏值统一设为"[REDACTED]"占位
AC 自动机匹配后，替换必须按坐标倒序处理
用 github.com/BobuSumisu/aho-corasick 找到所有 ac.Match 后，如果直接用 strings.ReplaceAll 全局替换，会因索引漂移导致漏匹配或错位。例如“苹果手机”里先替“苹果”，字符串变短，后面“手机”的起始位置就乱了。
正确做法是拿到所有 [start, end) 区间，按 start 降序排列，从后往前切片拼接。
- 调用
ac.FindAllStringIndex(text, true)获取重叠匹配（第二个参数必须为true） - 结果是
[][2]int，每个元素形如[2]int{3, 5}，代表下标 3 到 5（不含）被命中 - 用
sort.Slice(matches, func(i, j int) bool { return matches[i][0] > matches[j][0] })倒序 - 然后循环：
text = text[:i] + "[屏蔽]" + text[j:]，确保前面修改不影响后续i、j
配置文件反序列化时脱敏比日志过滤更关键
很多人在日志打点或 HTTP 响应时做脱敏，但敏感配置项（如 database.password）在 viper.Unmarshal 进结构体那一刻就已明文驻留内存。补救永远晚于泄露。
必须在解码环节拦截，用 mapstructure.DecodeHookFunc 按 key 路径判断是否脱敏，而不是靠字段值内容猜——否则 http://api.example.com?token=xxx 这种 URL 字段也会被误杀。
- hook 函数里拿到的是完整路径，如
"database.password"，用strings.Contains(strings.ToLower(keyPath), "password")判断 - 只对
f.Kind() == reflect.String && t.Kind() == reflect.String的转换生效，其他类型一律 passthrough - 环境变量绕过 hook？那就禁用自动映射，改用
viper.BindEnv("database.password", "DB_PASSWORD")，并在绑定前手动脱敏os.Getenv("DB_PASSWORD") - 目标结构体字段必须导出（首字母大写），否则
mapstructure根本不会赋值，hook 白写
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
