Go反射映射需手动处理可寻址性、标签解析、类型转换和嵌套边界；reflect.Value.Set()报错因值不可寻址或非导出字段；应传指针、检查CanAddr/CanSet、按json标签匹配、递归处理嵌套、缓存Type避免性能损耗。
Go 框架里用反射做结构体自动映射，不是“开箱即用”的魔法，而是得亲手处理字段可寻址性、标签解析、类型转换和嵌套边界——否则 runtime panic 或静默失败是常态。
reflect.Value.Set() 报 “cannot set” 怎么办
这是最常卡住的点：反射值必须同时满足 CanAddr() 和 CanSet() 才能写入。值拷贝、map 取值、字面量接口值，全都不行。
- 传参时别直接传结构体值，要传指针：
reflect.ValueOf(&obj).Elem() - 从
map[string]interface{}里取字段后，不能直接v := srcMap["name"]然后dstField.Set(v)；得先赋给局部变量再取地址：tmp := srcMap["name"]; reflect.ValueOf(&tmp).Elem() - 检查字段是否导出：非导出字段（小写首字母）
CanSet()永远返回 false，反射无法修改
怎么按 json 标签匹配字段而不是结构体名
反射本身不自动读标签，得手动提取并 fallback。比如目标字段有 json:"user_name"，源字段可能是 UserName 或 UserName json:"user_name"，不能只比名字。
- 遍历目标结构体字段时，用
field.Tag.Get("json")拿标签值；为空则 fallback 到field.Name - 查源数据（如 map）时，优先按 tag 名找键，没命中再试小写首字母名：
strings.ToLower(field.Name[:1]) + field.Name[1:] - 注意空字符串标签（
json:""）会覆盖字段名，需额外判断len(tag) > 0
嵌套结构体或 slice/map 字段怎么递归映射
反射不自动展开嵌套，必须自己写递归逻辑，且要防循环引用和类型错配。
立即学习“go语言免费学习笔记（深入）”；
- 遇到
Kind() == reflect.Struct，递归调用映射函数，但传参必须是dstField.Addr().Interface()（保证可寻址） - 遇到
reflect.Slice或reflect.Map，先确认目标字段类型与源数据类型一致（比如源是[]interface{}，目标是[]string就得逐项转换） - 深层嵌套时建议加深度限制（如 maxDepth=5），避免栈溢出；对已处理过的指针地址做缓存，防止无限递归
性能差太多，什么情况下该放弃反射
纯反射映射比硬编码字段赋值慢 5–20 倍，且编译期无法发现类型错误。真正在意性能或稳定性的场景，别硬扛。
- 高频调用路径（如 API 请求体解析、日志结构化）应改用代码生成（
go:generate+structomap类工具） - 字段固定、变更少的结构，直接手写
FromMap()方法，零反射开销 - 若仍要用反射，至少缓存
reflect.Type和字段索引（type fieldCache struct { fields []reflect.StructField }），避免每次重复遍历
最易被忽略的是：反射映射永远无法替代类型系统。它不校验业务约束（比如 “age 必须 > 0”），也不处理字段缺失时的默认值策略——这些都得在反射层之外补全，否则上线后才发现字段为零值，就晚了。
