Go JSON 的 null 为什么让指针字段变成 nil
来源:17golang原创
时间:2026-11-16 11:00:25 316浏览 收藏
Go 里用 encoding/json.Unmarshal 解析接口响应时,指针字段变成 nil 并不一定意味着代码出错。对 *T 字段来说,JSON 明确写出 null 时,解码器会把指针设为 nil;字段完全缺失时,解码器不会主动覆盖原值。若目标结构体刚创建出来,缺失字段本来就是零值,因此两种输入看起来可能完全一样。
核心判断:从零值结构体解析时,null和缺失字段都可能得到nil;复用已经有值的结构体时,null会清空指针,而缺失字段会保留旧指针。普通*T只能表达“有值/没有值”,不能单独还原三种输入状态。
null对指针字段的动作是设为nil,对普通字符串、数字等非指针字段通常不覆盖已有值。- 缺失字段不会调用覆盖动作;是否与
null看起来相同,取决于解析前结构体是不是零值。 - 需要区分“缺失、明确为空、明确有值”时,应增加出现标记或使用自定义解码类型。
官方文档:https://pkg.go.dev/encoding/json
先看清 null 和缺失字段不是同一个输入
下面两段 JSON 都没有提供有效的整数值,但语义不同。第一段是服务端明确返回了空值,第二段是响应里没有出现 age 这个成员。
{"age": null}
{}
如果 Go 结构体是刚声明的零值,Age *int 原本就是 nil,所以解析这两段 JSON 后都可能打印出 Age == nil。这只能说明当前内存里的指针为空,不能反推出服务端究竟返回了 null 还是省略了字段。

为什么 null 会把指针字段变成 nil
encoding/json 处理指针时,会先判断 JSON 值是否为 null。如果是,目标指针被设为 nil;如果不是,且目标指针当前为空,解码器会为指针指向的值分配空间,再把 JSON 内容写入其中。也就是说,nil 是 null 对 *T 的直接映射,不是整数零或字符串空值被“转换”出来的。
package main
import (
"encoding/json"
"fmt"
)
type Profile struct {
// Age 用指针表达“有一个可读取的整数”或“当前没有值”。
Age *int `json:"age"`
}
func main() {
var fromNull Profile
if err := json.Unmarshal([]byte(`{"age":null}`), &fromNull); err != nil {
panic(err) // 解码失败时不要继续把零值当成业务结果。
}
fmt.Println(fromNull.Age == nil) // true:明确的 null 让指针变成 nil。
var fromValue Profile
if err := json.Unmarshal([]byte(`{"age":18}`), &fromValue); err != nil {
panic(err) // 这里示例只关注指针字段的结果。
}
fmt.Println(*fromValue.Age) // 18:非 null 值会写入指针指向的整数。
}
对比普通值字段时要更谨慎。JSON null 不会自动变成字符串 "" 或数字 0;对于非指针、非 map、非 slice、非 interface 的目标,文档规定它通常对已有值不产生作用。若业务需要判断“空字符串”和“没有传这个字段”,也不能只看普通 string 的零值。
复用结构体时,缺失字段会保留旧指针
真正容易暴露差异的是把多个响应依次解码到同一个变量。第一段响应先让 Age 指向 18,第二段如果返回 null,指针会被清空;如果第二段只是省略 age,解码器不会把原来的指针重置为 nil。
package main
import (
"encoding/json"
"fmt"
)
type Account struct {
Age *int `json:"age"`
}
func main() {
initial := 18
account := Account{Age: &initial}
if err := json.Unmarshal([]byte(`{"age":null}`), &account); err != nil {
panic(err) // null 的结果需要保留,供后续业务判断。
}
fmt.Println(account.Age == nil) // true:明确的 null 清空已有指针。
account.Age = &initial // 重新准备一个已有值,演示缺失字段的行为。
if err := json.Unmarshal([]byte(`{}`), &account); err != nil {
panic(err) // 缺失 age 时,解码器不会主动覆盖 Age。
}
fmt.Println(*account.Age) // 18:缺失字段保留旧值。
}
这也是补丁式更新接口常见的坑:如果把“省略字段”定义为“保持原值”,复用结构体可以工作;如果每次响应都应代表一份完整资源,最好先创建新的零值结构体,或者在进入解码前明确重置目标。否则,上一轮响应留下的指针可能被误认为是本轮服务端返回的内容。

需要三种状态时,给字段增加出现标记
如果业务必须区分下面三种状态,单独的 *int 不够:
| 输入 | 普通值字段 | 指针字段 | 业务含义 |
|---|---|---|---|
{} | 保持旧值或零值 | 保持旧指针或 nil | 字段没有出现在本次 JSON 中 |
{"age":null} | 通常不覆盖已有值 | 设为 nil | 服务端明确表达空值 |
{"age":18} | 写入 18 | 指向 18 | 服务端明确提供值 |
最小的做法是为字段增加 Seen 标志,并实现 UnmarshalJSON。方法被调用就说明 JSON 中出现了该字段;方法参数是 null 时,再把 Valid 设为 false。这样就能同时保留“没出现”和“出现但为空”。
type OptionalInt struct {
Seen bool
Valid bool
Value int
}
func (o *OptionalInt) UnmarshalJSON(data []byte) error {
// Seen 记录字段出现过,Valid 再区分 null 与具体整数。
o.Seen = true
if string(data) == "null" {
o.Valid = false
o.Value = 0 // 清理旧值,避免调用方误读上一次内容。
return nil
}
if err := json.Unmarshal(data, &o.Value); err != nil {
return err // 保留类型错误,让调用方知道 JSON 不是整数。
}
o.Valid = true
return nil
}
上面的类型需要放在导入 encoding/json 的 Go 文件中,并作为结构体字段使用,例如 Age OptionalInt `json:"age"`。解码后,Seen=false 是缺失,Seen=true, Valid=false 是 null,Seen=true, Valid=true 才是具体整数。
排查指针变 nil 时先问这四件事
不要一看到 nil 就立刻改成普通值字段。先确认解析输入是否真的含有 null,再确认目标结构体是不是复用的,最后确认接口契约是否把“缺失”和“明确为空”定义成不同动作。若响应来自补丁更新,缺失字段通常应保持旧值;若响应是完整资源,建议每次解析新建目标,避免旧指针残留。
| 现象 | 优先判断 | 处理方向 |
|---|---|---|
| 零值结构体解析后指针为 nil | 输入是 null 还是字段缺失尚不明确 | 保留原始 JSON 或增加出现状态 |
| 解析 null 后旧指针消失 | 这是指针字段的正常覆盖语义 | 把 null 作为明确清空处理 |
| 字段缺失却保留旧对象 | 同一个结构体被重复解码 | 按完整响应或补丁响应选择重置策略 |
相关问题
JSON 的 null 会变成 int 的 0 吗?
不应这样理解。对普通整数目标,null 通常不覆盖已有值;只有目标本来是零值时,观察结果才可能恰好是 0。对 *int,直接结果是指针为 nil。
字段缺失和 null 都得到 nil,怎么区分?
不要只读取最终的指针值。可以保存原始 JSON、使用 json.RawMessage 先判断成员是否出现,或实现带 Seen 和 Valid 的自定义类型。
为什么重复 Unmarshal 后数据像“没有更新”?
字段缺失时,encoding/json 不会自动清空目标字段;如果目标结构体之前有值,缺失字段会留下旧值。完整响应与补丁响应应采用不同的对象生命周期。
-
502 收藏
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
462 收藏
-
168 收藏
-
404 收藏
-
425 收藏
-
127 收藏
-
366 收藏
-
121 收藏
-
346 收藏
-
390 收藏
-
313 收藏
-
496 收藏
-
322 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习