17370845950

Go中json.Marshal序列化失败的根本原因是字段未导出或标签使用不当；它依赖反射遍历导出字段，但仅处理首字母大写的字段，零值默认省略，私有字段需通过自定义MarshalJSON方法安全访问。

Go 里没有泛型反射的自动序列化魔法，reflect 本身不处理 JSON 格式，真正起作用的是 json.Marshal 对结构体字段的反射遍历 —— 所以“通用结构体序列化”的核心不是手写反射逻辑，而是正确导出字段 + 控制标签 + 理解零值行为。

为什么直接 json.Marshal 有时返回空对象或 null？

根本原因是字段未导出（首字母小写）或缺少必要标签。Go 的 json 包只序列化导出字段（即首字母大写的字段），且默认忽略零值字段（如空字符串、0、nil 指针等）。

• 结构体字段必须首字母大写，否则 json.Marshal 完全看不到它
• 如果字段是私有（小写）但你又想序列化，得用自定义 MarshalJSON 方法，不能靠 reflect 强行绕过导出规则
• json:"-" 标签会跳过该字段；json:",omitempty" 会在值为零值时省略（注意：指针类型判零是看是否为 nil，不是看它指向的值）

json.Marshal 底层怎么用 reflect？你不需要重写它

标准库的 json.Marshal 内部确实大量使用 reflect（比如 reflect.Value.Kind()、reflect.Value.Field()），但它已封装好所有边界逻辑：嵌套结构、指针解引用、接口类型分发、循环引用检测（会报错）、时间格式处理等。手动用 reflect 实现等价逻辑极易出错，且无法复用 json.Encoder 流式能力。

• 别写“用 reflect 遍历 struct 再拼 JSON 字符串” —— 这既慢又不兼容标准行为（比如不处理 time.Time）
• 需要动态控制字段行为？优先用 struct tag：json:"user_id,string" 表示把整数转成字符串输出
• 需要运行时决定哪些字段参与序列化？考虑用 map[string]interface{} 中转，或实现 MarshalJSON() 方法按需构造 []byte

如何安全地序列化含非导出字段或特殊逻辑的结构体？

唯一合规方式是为结构体实现 MarshalJSON() 方法。这时你可自由使用 reflect 获取私有字段值，但必须手动构造合法 JSON 字节流 —— 注意避免注入、保证引号/转义正确、处理嵌套结构的递归调用。

func (u User) MarshalJSON() ([]byte, error) {
    type Alias User // 防止无限递归
    return json.Marshal(struct {
        *Alias
        FullName string `json:"full_name"`
    }{
        Alias:    (*Alias)(&u),
        FullName: u.firstName + " " + u.lastName, // 访问私有字段
    })
}

• 用 type Alias 匿名嵌入是常见技巧，避免在 MarshalJSON 里直接调 json.Marshal(u) 导致死循环
• 不要在 MarshalJSON 里手动拼接字符串（如 "{\"name\":\"

  

  "+u.Name+"\"}"），易出错且不处理特殊字符
• 若字段类型不支持标准 JSON（如 net.IP、自定义错误），应在该方法内先转成基础类型（string 或 map）再交由 json.Marshal

真正难的不是“怎么用 reflect”，而是理解 Go 的导出规则、JSON 零值语义、以及何时该让步给标准库 —— 大多数所谓“通用序列化需求”，其实只是没写对 struct tag 或误信了“反射万能论”。