Go语言指针与值的JSON序列化差异

Go语言中指针与值类型字段在JSON序列化时行为截然不同：nil指针默认被完全忽略（连key都不出现），而值类型字段无论是否为零值（如0、""、false）都会强制输出，导致前后端对“未设置”“空值”“零值”的语义理解错位；Go 1.19+引入的`json:",null"`可显式输出null，`omitempty`则需谨慎使用——它对指针判nil、对值类型判零值；嵌套结构更易因混用指针与值类型引发兼容问题，建议对外API统一采用带明确文档说明的指针策略；还需注意自定义`MarshalJSON`无法拦截nil指针调用。这一底层差异若忽视，极易在跨团队协作、SDK生成或线上环境触发静默故障，是Go开发者必须厘清的关键序列化陷阱。

JSON序列化时 nil 指针字段默认被忽略

Go 的 json.Marshal 对结构体中为 nil 的指针字段（如 *string、*int）默认不输出对应 key，哪怕你显式设为 nil。这不是 bug，是标准行为——因为 nil 指针的零值就是“未设置”，JSON 编码器跳过它。

常见错误现象：前端收不到字段，以为后端没传，实际是字段类型用了指针且值为 nil，但没加 omitempty 或其他标记，结果连 key 都没了。

• 若想让 nil 指针也输出 null，需给字段加 json:",null" 标签（注意：Go 1.19+ 支持，旧版本不生效）
• 更通用的做法是用 json:",omitempty" 显式控制，但注意：omitempty 对指针只判断是否 nil，对值类型则判断是否为零值（比如 ""、0、false）
• 别依赖指针“自动区分未设置和设为空”，除非你清楚知道每个字段在业务语义上是否需要三态（未设置 / null / 有值）

json.Marshal 对值类型字段总是输出，零值也会变成 false/0/""

结构体字段是值类型（如 string、int、bool）时，只要它在结构体中声明了，json.Marshal 就一定会输出该 key，值为其 Go 零值对应的 JSON 表示。

使用场景：API 响应中某些字段必须存在（即使为空），比如分页接口的 next_cursor 字段，定义为 string 类型比 *string 更稳妥，避免前端因字段缺失而报错。

• int 字段为 0 → JSON 输出 0，不是 null
• string 字段为 "" → JSON 输出 ""，不是 null 或缺失
• 如果业务上 “0” 和 “未提供” 语义不同，就不能用值类型，得改用指针 + 显式 null 处理逻辑

嵌套结构体中指针与值混用导致序列化行为不一致

当一个结构体字段是另一个结构体指针（如 *User）时，若该指针为 nil，整个子对象不会出现在 JSON 中；但如果字段是值类型（如 User），哪怕所有字段都是零值，也会输出一个空对象 {}。

容易踩的坑：前后端约定某嵌套字段“可选”，后端用 *SubConfig 实现，但前端解析时假设该字段要么存在要么不存在，结果遇到 nil 指针就完全收不到 key，而测试数据里又恰好初始化了，上线后才发现兼容问题。

• 统一用指针嵌套？风险是下游 SDK 可能 panic 解引用 nil
• 统一用值类型嵌套？风险是空对象 {} 可能被前端误认为“已配置但为空”
• 建议：对外 API 的嵌套对象字段，优先用指针，并配合文档说明 null 表示“未设置”，非 null 才解析内部字段

自定义 MarshalJSON 方法无法绕过指针 nil 判断

即使为某个指针类型实现了 MarshalJSON 方法，如果调用方传入的是 nil 指针，Go 运行时根本不会调用该方法——而是直接返回 null（或跳过，取决于上下文）。这是语言层限制，不是 JSON 包的 bug。

例如定义了 type MyString *string 并实现 MarshalJSON()，但若变量是 var s MyString = nil，序列化结果仍是 null，不会进你的方法体。

• 验证方式：在 MarshalJSON 开头加 fmt.Println("called")，然后传 nil 值，会发现没打印
• 真正可控的时机只有在非 nil 指针上，所以逻辑里必须先判空，再做自定义处理
• 如果真需要 nil 指针也走自定义逻辑，只能在外层包装一层值类型（比如用 struct{ V *string }），并在其 MarshalJSON 中处理 nil 分支

实际编码中，最常被忽略的是：**指针字段的 nil 不等于“空”，它代表“未参与本次序列化”；而值类型的零值是明确参与序列化的语义存在**。这个差异一旦混用，在跨团队协作或 SDK 自动生成时极易引发静默错误。

今天关于《Go语言指针与值的JSON序列化差异》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！