go的json.Marshal为空对象主因是字段未导出（小写首字母）或存在循环引用；需确保字段大写、用Struct tag控制key、排除func/chan等不支持类型，并为time.Time和循环结构显式处理。
字段未导出导致 Marshal 为空对象
Go 的 json.Marshal 只能序列化导出（首字母大写）的结构体字段。如果字段是小写字母开头，比如 name、age，Marshal 后对应字段会直接消失，结果可能是空对象 {} 或缺失关键数据。
常见现象：结构体看起来有值，但输出 JSON 是 {} 或部分字段丢失。
- 确保字段名首字母大写：
Name、Age - 用 struct tag 显式控制 key 名：
type User struct { Name String `json:"name"` } - 检查嵌套结构体——每一层都要满足导出规则
包含不支持类型的字段（如 func、channel、unsafe.Pointer）
json.Marshal 遇到无法表示为 JSON 的类型时会返回错误，典型错误信息是：json: unsupported type: func() 或 json: unsupported type: chan int。
这类问题常出现在误将方法接收器、回调函数或 goroutine 通信结构体直接塞进待序列化对象中。
立即学习“go语言免费学习笔记（深入）”；
- 排查结构体中是否含
func、chan、map[Interface{}]interface{}、interface{}（且运行时值为不支持类型） - 对
interface{}字段，务必确认其底层值是 JSON 可编码类型（string/number/bool/map/slice/nil） - 临时排除法：逐个注释字段后重试 Marshal，定位问题字段
time.Time 默认编码格式不符合预期或 panic
直接 Marshal time.Time 会使用 RFC 3339 格式（如 "2024-05-22T14:30:00Z"），但若结构体字段是未初始化的零值 time.Time{}，且没有设置 omitempty，就可能触发 json: invalid use of ,string struct tag, trying to unmarshal unquoted value into time.Time 类似错误（多见于反序列化，但编码时若嵌套在 interface{} 中也可能出问题）。
- 推荐显式处理时间字段：
CreatedAt time.Time `json:"created_at"`并确保非零值，或用指针*time.Time配合omitempty - 如需自定义格式，实现
MarshalJSON()方法，返回带引号的字符串字节 - 避免把
time.Time存进map[string]interface{}后再 Marshal —— 它不会自动调用自定义方法
嵌套结构体中存在循环引用
Go 的标准库 json 包不检测或处理循环引用。一旦结构体 A 持有 B，B 又持有 A（或通过指针间接形成环），json.Marshal 会无限递归，最终触发栈溢出 panic（runtime: goroutine stack exceeds 1000000000-byte limit）。
这种问题在 ORM 模型（如 GORM 的关联字段）或树形结构中较隐蔽。
- 检查是否有
*Parent和Children []*node这类双向引用 - 临时解法：用匿名结构体投影需要的字段，避开指针引用：
json.Marshal(struct { ID int `json:"id"` Name string `json:"name"` }{u.ID, u.Name}) - 长期方案：为结构体实现
MarshalJSON()，手动控制遍历深度或跳过循环字段
字段导出规则和循环引用是最容易被忽略的两个点，尤其在团队协作或接入第三方模型时，看似“结构体定义好了”其实埋了静默失败的坑。