反射读取 map 值时 panic: reflect: call of reflect.Value.MapKeys on zero Value
这是最常遇到的崩溃，本质是传入了 nil map 或未初始化的 map 类型变量。反射无法对空值调用 MapKeys、MapIndex 等方法。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
v.Kind() == reflect.Map判断类型，再用v.IsNil()检查是否为 nil —— 注意：只有指针、slice、map、chan、func、interface 才能调用IsNil() - 如果原始变量是
var m map[string]int，直接reflect.ValueOf(m)得到的就是零值Value，此时IsNil()返回 true，但MapKeys()会 panic - 避免直接反射未赋值的局部 map 变量；若需统一处理，可包装一层非空检查逻辑
用 reflect.Value.SetMapIndex 写入 map 时值不生效
根本原因是 map 的底层结构不可寻址（unaddressable），而 SetMapIndex 要求 map 本身是可寻址的 —— 即必须从指针或字段中获取，不能来自 reflect.ValueOf(myMap) 这种拷贝值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保传入的是指针：用
reflect.ValueOf(&myMap).Elem()获取可寻址的 map value -
SetMapIndex的 key 和 value 参数也必须是reflect.Value，且类型要严格匹配 map 定义（比如map[string]*int中的 value 必须是*int类型的reflect.Value） - 常见错误：把 int 直接传给
SetMapIndex的 value 参数，忘了用reflect.ValueOf(&v).Elem()包装指针值
遍历 map 时 key/value 类型丢失导致类型断言失败
反射取出的 key 和 value 是 reflect.Value，不是原始 Go 类型。直接用 interface{}(v).(*string) 这类断言会失败，因为底层类型不是 *string，而是 reflect.Value。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
v.Interface()获取真实 Go 值（注意：该值仍是只读副本，修改它不影响原 map） - 如果 map 的 key 是
string，那么keyVal.Interface().(string)是安全的；但如果 key 是自定义 struct，务必确认其导出字段和接口实现 - 避免在循环里反复调用
v.Interface()处理大量数据 —— 它有分配开销；高频场景建议提前判断v.Kind()分支处理
嵌套 map 反射解包性能差且易栈溢出
对 map[string]interface{} 或 map[string]map[string]interface{} 层层递归反射，每层都新建 reflect.Value，不仅慢，还容易因深度过深触发 runtime 栈检查失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先考虑用
json.Unmarshal+ struct tag 解析，比纯反射快 3–5 倍，且更可控 - 若必须反射嵌套 map，限制递归深度（比如最多 8 层），并在每层检查
v.Kind() == reflect.Map后再进入下一层 - 不要用
reflect.Value.String()打日志调试嵌套 map —— 它会触发完整结构展开，可能卡死或 OOM
