json.Unmarshal无法填充未导出字段，因Go反射机制仅允许访问首字母大写的导出字段；尝试写入未导出字段会panic。解决方法是将需JSON支持的字段改为导出，并通过封装控制访问。
为什么 json.Unmarshal 无法直接填充未导出字段
Go 的 json 包在反序列化时只访问结构体的**导出字段**（首字母大写），这是由 Go 反射机制和包可见性规则共同决定的。即使你用 reflect.Value.Set() 尝试写入未导出字段，也会 panic 报错 reflect: reflect.Value.Set using unexported field。
常见误操作是给字段加 json: tag 却忘了导出，比如：
type User struct {
name string `json:"name"` // ❌ name 是小写，不会被 json.Unmarshal 处理
Age int `json:"age"`
}
解决思路不是绕过导出规则，而是：明确哪些字段需要 JSON 支持 → 改为导出字段 → 必要时用封装控制外部访问。
如何用反射动态读取结构体的 JSON tag 和字段值
当你需要在运行时分析结构体字段的 JSON 映射关系（比如做通用日志打点、字段校验、API 文档生成），reflect 是唯一选择。关键点在于：必须从 reflect.Type 获取 tag，再用 reflect.Value 获取对应值。
立即学习“go语言免费学习笔记（深入）”；
- 使用
t.Field(i).Tag.Get("json")提取 tag 字符串，返回形如"name,omitempty"的内容 - 需手动解析
omitempty、别名（如"user_name"）、忽略标记（"-"） - 若字段是嵌套结构体或指针，
v.Field(i).Interface()可能 panic，应先检查v.Field(i).CanInterface() - 对空指针字段调用
v.Field(i).Interface()会 panic，建议用v.Field(i).IsNil()预判
示例：遍历并打印所有非忽略的 JSON 字段名与当前值
func printJSONFields(v interface{}) {
rv := reflect.ValueOf(v)
if rv.Kind() == reflect.Ptr {
rv = rv.Elem()
}
rt := rv.Type()
for i := 0; i < rv.NumField(); i++ {
field := rt.Field(i)
tag := field.Tag.Get("json")
if tag == "-" || strings.HasPrefix(tag, ",") {
continue
}
name := strings.Split(tag, ",")[0]
if name == "" {
name = field.Name
}
if rv.Field(i).CanInterface() {
fmt.Printf("%s: %+v\n", name, rv.Field(i).Interface())
}
}
}
如何安全地用反射修改导出字段的 JSON 值（比如脱敏、注入时间戳）
在反序列化后、业务逻辑前，有时需统一处理字段（如将手机号脱敏、补全 CreatedAt）。此时可借助反射遍历并修改，但必须满足：字段可寻址（reflect.Value.CanSet() 返回 true）且已导出。
- 传入参数必须是指针，否则
reflect.ValueOf(x).CanSet()恒为 false - 对
string类型字段，用v.SetString(newVal)；对int用v.SetInt(123)；类型不匹配会 panic - 嵌套结构体字段需递归处理，但注意不要无限循环（如自引用结构）
- 如果字段是
nil指针（如*string），需先用v.Set(reflect.New(v.Type().Elem()))初始化再赋值
典型场景：自动注入 UpdatedAt 字段
func injectUpdatedAt(obj interface{}) {
v := reflect.ValueOf(obj)
if v.Kind() != reflect.Ptr || v.IsNil() {
return
}
v = v.Elem()
if v.Kind() != reflect.Struct {
return
}
t := v.Type()
for i := 0; i < v.NumField(); i++ {
if t.Field(i).Name == "UpdatedAt" && v.Field(i).CanSet() && v.Field(i).Kind() == reflect.Int64 {
v.Field(i).SetInt(time.Now().UnixMilli())
}
}
}
用反射实现 JSON 字段名到结构体字段的双向映射（避免硬编码）
当 API 返回字段名不固定（比如不同版本返回 user_id 或 uid），又不想写多个 struct，可用反射构建字段名 → 字段索引的 map。核心是遍历 reflect.Type 并提取 json tag 中的主名称。
- 字段名解析需考虑别名：如
json:"user_id,string"中取user_id，忽略后续修饰 - 重复 JSON 名称（多个字段 tag 相同）会导致覆盖，应提前报错或跳过
- 映射表建议缓存（
sync.Map或包级变量），避免每次反射遍历开销 - 若字段是匿名嵌入结构体，其字段默认“提升”，但 tag 不会自动继承，需显式设置
简版映射构造逻辑：
func buildJSONMap(t reflect.Type) map[string]int {
m := make(map[string]int)
for i := 0; i < t.NumField(); i++ {
tag := t.Field(i).Tag.Get("json")
if tag == "" || tag == "-" {
continue
}
name := strings.Split(tag, ",")[0]
if name != "" {
m[name] = i
}
}
return m
}
实际使用时，先调用 buildJSONMap(reflect.TypeOf(MyStruct{})) 得到映射，再在 UnmarshalJSON 方法里按需填充字段 —— 这比完全手写 UnmarshalJSON 更轻量，也比纯反射赋值更可控。
真正难的不是反射本身，而是 tag 解析的边界情况：空字符串、逗号分隔的多个 flag、转义、嵌套结构体字段提升后的命名冲突。这些细节不写测试很容易漏掉。
