json.Marshal返回空字符串或nil的常见原因是结构体字段未导出（首字母小写），encoding/json只能序列化导出字段；解决方式是将字段首字母大写或用json:”name”显式标记，且字段必须导出。
为什么 json.Marshal 会返回空字符串或 nil
常见原因是结构体字段未导出（首字母小写），encoding/json 只能序列化导出字段。比如：
type User struct {
name string // 不会被编码
Email string // 会被编码
}
即使赋了值，name 字段在 JSON 中完全消失，容易误以为编码失败。解决方式只有把字段名首字母大写，或用 json: tag 显式控制（但前提是字段本身导出）。
- 字段必须首字母大写（即导出）才能被
json.Marshal访问 -
json:"-"可忽略字段，json:"email,omitempty"可跳过零值字段 - 如果传入
nil指针或未初始化的 interface{}，Marshal会返回null，不是错误
如何处理嵌套结构体中的空值与零值
默认情况下，json.Marshal 会把 0、""、false、nil 等零值原样输出。想跳过它们，得靠 omitempty tag：
type Config struct {
Timeout int `json:"timeout,omitempty"`
Host string `json:"host,omitempty"`
Active bool `json:"active,omitempty"`
}
但要注意：omitempty 对指针、接口、map、slice、数组有效，对普通数值类型（如 int）只判断是否为零值，无法区分“用户设为 0”和“未设置”。若需精确控制，应改用指针类型：
立即学习“go语言免费学习笔记（深入）”；
-
*int类型字段为nil时才被 omitempty 跳过；设为new(int)并赋值 0，则会输出"timeout": 0 - 嵌套结构体字段也需各自加 tag，父结构体的 tag 不会自动继承
- 使用
json.RawMessage可延迟解析某字段，避免提前解码失败
json.Unmarshal 解析失败却不报错的典型原因
最常踩的坑是：传入非指针变量，导致解析静默失败。例如：
var u User json.Unmarshal(data, u) // ❌ 传值，无任何修改，也不报错
正确做法永远是传指针：
json.Unmarshal(data, &u) // ✅
其他易忽略点：
- 目标结构体字段未导出 → 解析成功但字段保持零值，无提示
- JSON 字段名和 struct tag 不匹配（大小写、下划线等），且没写
json:"xxx"→ 字段被忽略 - JSON 中数字超出 Go 整型范围（如超
int64），会解析成 float64，再转整型时 panic；可先用json.Number捕获原始字面量 - 字段类型不兼容（如 JSON
"123"试图解析进int）会直接返回json.UnmarshalTypeError
如何安全地处理未知结构的 JSON（如 Webhook 通用 payload）
不要硬写一个大 struct 去匹配所有可能字段。更稳妥的方式是分层解析：
- 先用
map[string]interface{}或json.RawMessage接住顶层字段，按 key 判断类型再分支解析 - 对动态 key（如用户 ID 作 map key），必须用
map[string]json.RawMessage，否则会提前解码失败 - 若需校验字段存在性，别依赖结构体零值判断（如
u.Name == ""），而应检查对应 key 是否在 map 中，或用json.Unmarshal配合自定义UnmarshalJSON方法
复杂场景下，json.RawMessage 是关键缓冲层 —— 它把一段 JSON 字节流暂存为字节切片，直到你明确决定怎么解析它。