答案：用Go反射做通用日志封装需按需提取结构体内容，核心是安全、可控、高效。1. 只处理导出字段，利用首字母大写保证可读性，敏感字段用log:"-"或redact标记；2. 反射前校验类型和可访问性，避免nil或非结构体输入引发panic；3. 通过log tag控制字段行为（如忽略、脱敏），提升灵活性；4. 遍历时限制递归深度并缓存已访问指针，防止栈溢出和循环引用；5. 基础类型走快速路径，高频结构体预生成日志方法，结合sync.Pool降低开销；6. 禁用fmt.Sprintf("%+v")等低效替代方案，确保输出简洁可读。反射为手段，服务日志才是目的。
用 Go 反射做通用日志封装，核心不是“把所有字段打出来”，而是按需、可控、安全地提取结构体内容，避免 panic、隐私泄露和性能浪费。关键在反射前加约束，反射时做裁剪，反射后做格式化。
只对导出字段做日志提取
Go 反射无法访问非导出（小写开头）字段，这是天然的安全边界。但要注意：别试图绕过它（比如用 unsafe），否则破坏 Go 的封装约定，也容易出错。
- 确保要记录的字段名首字母大写（如 ID、UserName）
- 若结构体含敏感字段（如 Password），要么不导出，要么用 tag 显式忽略
- 反射前先检查
v.CanInterface()和v.Kind() == reflect.Struct，防止传入 nil 或非结构体
用 struct tag 控制字段是否参与日志
通过自定义 tag（如 log:"-" 或 log:"name,redact"）声明字段行为，比硬编码字段名更灵活可维护。
- 定义 tag key 统一为 log，值支持空（默认记录）、-（忽略）、redact（脱敏）、omitempty（空值跳过）
- 反射遍历时，用
field.Tag.Get("log")解析策略，再决定是否取值或替换为"***" - 示例：
type User struct { Password string `log:"redact"` }→ 日志中显示Password: "***"
避免递归爆炸与循环引用
结构体嵌套过深或含指针循环（如 A→B→A）时，直接递归反射会栈溢出或无限循环。需加深度限制和已访问对象缓存。
立即学习“go语言免费学习笔记（深入）”；
- 传入最大递归深度（如 3），每进一层减一，到 0 就停止深入
- 用
map[uintptr]bool缓存已处理对象的地址（unsafe.Pointer(v.UnsafeAddr())），遇到重复地址直接跳过 - 基础类型（string/int/bool 等）、常见包装类型（time.Time、uuid.UUID）走快速路径，不递归
日志键值对生成与性能平衡
反射本身有开销，不能每次打日志都全量反射。建议结合 sync.Pool 缓存反射结果，或对高频结构体做代码生成（go:generate）预编译日志方法。
- 首次反射后，把字段名+获取器函数缓存到
sync.Map[string]func(interface{}) map[string]interface{} - 对稳定结构体（如 HTTP 请求上下文、DB 模型），用
go generate+structinfo工具生成无反射的日志方法，零 runtime 开销 - 线上环境慎用
fmt.Sprintf("%+v", v)替代反射——它不识别 tag，且输出冗长难读
基本上就这些。反射是手段，不是目的；日志是服务，不是负担。控制好边界、留好扩展点、盯住 panic 和性能毛刺，通用日志封装就不复杂但容易忽略。
