当前位置:首页 > 文章列表 > Golang > Go问答 > Go JSON 的 null 为什么让指针字段变成 nil

Go JSON 的 null 为什么让指针字段变成 nil

来源:17golang原创 2026-11-16 11:00:25 0浏览 收藏

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删除
Go HTTP 服务 Shutdown 返回超时错误怎么办Go HTTP 服务 Shutdown 返回超时错误怎么办
上一篇
Go HTTP 服务 Shutdown 返回超时错误怎么办
Go HTTP 流式响应调用 Flush 后客户端仍不实时显示
下一篇
Go HTTP 流式响应调用 Flush 后客户端仍不实时显示
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1049次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1045次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1206次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1151次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    995次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码