登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

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 还是省略了字段。

Go encoding/json 中 JSON null 与缺失字段进入指针字段的输入关系说明图
图1:静态说明图,比较 JSON 明确为 null 与字段缺失进入 Go 指针字段时的输入差异。

为什么 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:缺失字段保留旧值。
}

这也是补丁式更新接口常见的坑:如果把“省略字段”定义为“保持原值”,复用结构体可以工作;如果每次响应都应代表一份完整资源,最好先创建新的零值结构体,或者在进入解码前明确重置目标。否则,上一轮响应留下的指针可能被误认为是本轮服务端返回的内容。

Go 指针字段从已有值经过 JSON null 或缺失字段后的生命周期对比结构图
图2:静态结构图,展示同一个 Go 结构体在已有指针时分别遇到 null 与缺失字段的状态变化。

需要三种状态时,给字段增加出现标记

如果业务必须区分下面三种状态,单独的 *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 不会自动清空目标字段;如果目标结构体之前有值,缺失字段会留下旧值。完整响应与补丁响应应采用不同的对象生命周期。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>