Go 的 json.Unmarshal 不会填充结构体字段默认值，因为其设计仅覆盖 JSON 中显式存在的字段，缺失字段保持 Go 类型零值，且忽略字段声明时的初始化表达式（Go 本身不支持字段级默认值语法）。
为什么 json.Unmarshal 不会填充结构体字段的默认值
Go 的 json 包在解码时只覆盖 JSON 中显式存在的字段，对缺失字段不做任何赋值——哪怕结构体字段声明了初始值（比如 Age int `json:"age"` 声明为 0），也不会“回填”这个 0。空字符串 "" 或仅含空对象 "{}" 解码后所有字段都保持零值，但你无法区分“用户没传”和“用户传了 null / 空值”。这导致后续逻辑容易出错，比如把未传的 string 字段当作 "" 处理，而其实它本该是 "default"。
用 json.RawMessage 延迟解析 + 手动补默认值
最可控的方式是先用 json.RawMessage 把原始 JSON 保留下来，再按需解析并填充。适用于字段少、默认逻辑明确的场景：
type User struct {
Name string `json:"name"`
Role string `json:"role"`
}
func ParseUserWithDefaults(data []byte) (User, error) {
var raw map[string]json.RawMessage
if err := json.Unmarshal(data, &raw); err != nil {
return User{}, err
}
u := User{
Name: "anonymous", // 默认值
Role: "user",
}
if nameBytes, ok := raw["name"]; ok && len(nameBytes) > 0 {
json.Unmarshal(nameBytes, &u.Name)
}
if roleBytes, ok := raw["role"]; ok && len(roleBytes) > 0 {
json.Unmarshal(roleBytes, &u.Role)
}
return u, nil
}
- 必须检查
len(raw["field"]) > 0，否则json.RawMessage为空字节切片时Unmarshal会静默失败 - 不支持嵌套结构体自动递归填充，得手动一层层写
- 字段名拼写错误或大小写不匹配时不会报错，而是跳过，容易漏补
用自定义 UnmarshalJSON 方法实现字段级默认逻辑
为结构体实现 UnmarshalJSON 是更健壮的选择，能复用标准解析流程，同时控制每个字段的行为：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
func (u *User) UnmarshalJSON(data []byte) error {
type Alias User // 防止无限递归
aux := &struct {
Name *string `json:"name"`
Role *string `json:"role"`
*Alias
}{
Alias: (*Alias)(u),
}
if err := json.Unmarshal(data, aux); err != nil {
return err
}
if aux.Name != nil {
u.Name = *aux.Name
} else {
u.Name = "anonymous"
}
if aux.Role != nil {
u.Role = *aux.Role
} else {
u.Role = "user"
}
return nil
}
- 用指针字段接收 JSON 值，
nil表示该字段未出现在 JSON 中 - 必须用
type Alias User避免方法调用自身导致栈溢出 - 如果字段类型是
int、bool等，对应辅助字段要用*int、*bool，否则无法区分“0/false”和“未提供”
警惕第三方库（如 mapstructure）的默认值陷阱
像 github.com/mitchellh/mapstructure 支持 default tag，但默认行为不等于 JSON 解码语义：
立即学习“go语言免费学习笔记（深入）”；
type Config struct {
Timeout int `mapstructure:"timeout" default:"30"`
}
-
mapstructure.Decode只在 map key 不存在时才用 default；但如果 JSON 里写了"timeout": null或"timeout": 0，它仍会赋值，不会触发 default - 它不处理 JSON 字符串到结构体的直接转换，需先
json.Unmarshal到map[string]interface{}，多一次序列化开销 - 对嵌套结构体、切片、指针字段的支持边界模糊，容易出现 panic 或静默忽略
真正要安全填充，默认逻辑必须基于“字段是否出现在 JSON 中”，而不是“解码后是否为零值”——后者无法区分有意传 0 和根本没传。
