Golang指针在JSON序列化中的空值处理

Golang中指针与JSON序列化的交互看似简单，实则暗藏多重陷阱：`json.Marshal`对nil指针默认输出`null`而非省略，需显式添加`omitempty`标签才能跳过，但该标签仅判断字段是否为零值（如指针是否为nil），不穿透检查嵌套结构的实际内容；反序列化时若将JSON的`null`映射到非指针类型（如`string`）会直接panic，安全做法是统一使用指针字段接收可能为空的字段；更易被忽视的是嵌套指针+`omitempty`的语义偏差、`interface{}`对`null`的弱类型处理风险，以及空对象`{}`与`null`在业务含义上的本质区别——这些边界场景往往在测试中难以覆盖，唯有结合日志验证实际类型与值，才能避免线上崩溃。

Go 的 json.Marshal 遇到 nil 指针会输出 null

当你把一个结构体字段声明为指针（比如 *string），而该字段值是 nil，json.Marshal 默认会把它序列化成 JSON 的 null，而不是跳过它或报错。

这很常见，但容易误以为“字段没传就该消失”，其实不是——只要字段在 struct 里定义了，且类型是指针，nil 就对应 null。

• 如果想让 nil 指针字段完全不出现，得加 omitempty 标签：json:"name,omitempty"
• omitempty 对指针有效，但对零值非指针类型（如 int、string）也生效，这点容易混淆
• 注意：omitempty 不影响顶层 nil 指针变量本身——比如你传 json.Marshal((*MyStruct)(nil))，会直接 panic，错误是 json: Marshal(nil *MyStruct)

反序列化时 json.Unmarshal 对 null 的处理逻辑

JSON 中的 null 反序列化到 Go 指针字段时，会把对应指针设为 nil；但如果目标字段是非指针类型（比如 string），就会报错：json: cannot unmarshal null into Go value of type string。

这是最常踩的坑：前端传了个 {"name": null}，后端用 type User struct { Name string } 接收，直接炸。

• 安全做法是统一用指针字段接收可能为 null 的字段：Name *string
• 如果必须用非指针类型，得自定义 UnmarshalJSON 方法，或用第三方库（如 github.com/mitchellh/mapstructure）做宽松解析
• 空对象（{}）和 null 是两回事：{} 表示对象存在但字段全缺，null 表示那个字段明确为空——反序列化时前者会让指针保持 nil（如果没显式赋值），后者也会设为 nil，但语义不同

嵌套结构中指针字段的 omitempty 行为陷阱

当结构体嵌套，且内层字段是指针，omitempty 不会“穿透”判断内层是否真有值。它只看当前字段是否为零值（对指针就是是否为 nil），不关心 nil 指针指向的对象本身有没有意义。

比如：type Req struct { Data *Inner `json:"data,omitempty"` }，即使 Data 指向一个 &Inner{Field: ""}（所有字段都是零值），只要 Data != nil，data 字段仍会出现在 JSON 中，内容是 {"field":""}。

• 想实现“深层空则省略”，得手动在 MarshalJSON 里判断内层字段是否全为零
• 别依赖 omitempty 来隐藏业务上的“无效对象”，它只认 Go 的零值规则
• 测试时容易漏掉这种 case：用 new(Inner) 初始化再赋值为零值，结果发现字段还在 JSON 里

接口字段（interface{}）与指针混用时的反序列化风险

如果你用 map[string]interface{} 或 interface{} 接收未知结构，JSON 中的 null 会被解成 Go 的 nil，但它的类型是 ，不是 *string 或其他具体指针类型。

后续如果强制类型断言为 *string，会 panic：panic: interface conversion: interface {} is nil, not *string。

• 务必先用 if v != nil 判断，再做类型断言
• 更稳妥的方式是用 json.RawMessage 延迟解析，或者用 json.Unmarshal 直接进具体结构体
• 别在 interface{} 上做指针解引用操作——它根本不知道自己是不是指针

事情说清了就结束。指针和 JSON 的交互看着简单，真正出问题往往在嵌套 + omitempty + 接口混合使用的边界场景，这时候靠猜不如加一行日志打出来看实际类型和值。

本篇关于《Golang指针在JSON序列化中的空值处理》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！