安全获取结构体字段需确保字段导出(首字母大写),用reflect.Value.Field(i)配合field.Tag.Get("json")读取标签;空或"-"标签跳过,含omitempty时调用IsZero()判断,驼峰转下划线等需手动实现。

Go 语言中,reflect 包是实现通用序列化的唯一可行路径——没有泛型约束时,它能绕过编译期类型检查,动态处理任意结构体、嵌套、指针、slice、map 等;但必须手动处理零值、标签解析、递归边界和可导出性,否则会 panic 或输出空数据。
如何安全获取结构体字段并读取 json 标签
结构体字段必须导出(首字母大写),否则 reflect.Value.Field(i) 无法访问,且 field.Tag.Get("json") 返回空字符串。常见错误是误用 reflect.VisibleFields(Go 1.15+)却忽略其不包含非导出字段的特性。
-
reflect.TypeOf(v).NumField()只返回导出字段数,非导出字段被直接跳过 - 字段标签为空或为
"-"时,应跳过该字段,避免生成无效 key - 若标签含
omitempty,需调用v.Field(i).IsZero()判断是否省略(注意:该方法对指针、interface{} 等类型行为不同) - 字段名驼峰转小写下划线等逻辑需自行实现,标准库
json包不暴露此能力
为什么解引用指针时必须先检查 IsNil()
对 nil 指针调用 Elem() 会直接 panic:reflect: call of reflect.Value.Elem on zero Value。这不是可恢复错误,而是运行时崩溃。
- 必须先判断
v.Kind() == reflect.Ptr && !v.IsNil(),再调用v.Elem() - 解引用后若仍是指针(如
**T),需循环处理,但深度建议限制(如 ≤5 层),防栈溢出 - 对
nil指针字段,按 JSON 规范应输出null,而非跳过或 panic
如何统一处理 map[int]T 和 map[string]T 的键类型
标准 encoding/json 对 map[int]T 的键会自动转为字符串,但自定义序列化器不会——它会因键类型不匹配而 panic:json: unsupported type: map[int]User。
- 必须在进入 map 分支前,用
v.Type().Key().Kind()判断键是否为整数类(reflect.Int、reflect.Int64等) - 不能直接
map[string]interface{}类型断言,而要用reflect.MakeMapWithSize(reflect.MapOf(reflect.TypeOf("").Type, elemType), v.Len())动态构造目标 map - 键转换用
fmt.Sprintf("%v", key.Interface())最稳妥,避免strconv对负数或大整数的格式差异
反射序列化最易被忽略的是接口值的双重包装:当你传入 interface{},reflect.ValueOf() 得到的是接口底层值的 Value,但若该接口本身是空接口(如 var x interface{} = struct{}{}),需额外一层 v.Elem() 才能拿到实际结构体——这个间接层级在嵌套深时极易漏判。


















