0

0

如何在Golang中处理JSON反序列化中的指针字段 Go语言空值与零值区分

P粉602998670

P粉602998670

发布时间:2026-03-10 10:46:03

|

292人浏览过

|

来源于php中文网

原创

go json反序列化中nil指针字段保持nil,需用*string等指针类型并保持未初始化才能赋值;区分“缺失”与“null”须用json.rawmessage或自定义unmarshaljson。

如何在golang中处理json反序列化中的指针字段 go语言空值与零值区分

Go JSON反序列化时 nil 指针字段不会被赋值,除非显式声明为指针类型

JSON 解析器(json.Unmarshal)默认只填充结构体中「已初始化」的字段。如果字段是 *string*int 这类指针类型,但结构体实例里该字段是 nil,反序列化时它依然保持 nil —— 即使 JSON 里有对应 key 和非空值。

常见错误现象:json.Unmarshal 后发现 *string 字段还是 nil,但日志打印 JSON 明明有这个字段;或者用 omitempty 导致字段被跳过,误以为数据丢了。

  • 必须把字段定义成指针类型(如 *string),且不预先初始化(保持 nil),才能让 json.Unmarshal 在遇到 JSON 中该字段时「分配新内存并写入」
  • 如果字段是 string(非指针),JSON 为空字符串 "" 或缺失,都会变成零值 "",无法区分「没传」和「传了空字符串」
  • json.RawMessage 可临时绕过解析,适合延迟判断字段是否存在,但需手动再解一次

json.RawMessage + 延迟解析判断字段是否真实存在

当必须严格区分「JSON 中无该字段」和「字段值为 null / 零值」时,json.RawMessage 是最直接的手段:它把原始字节原样存下来,不触发类型转换。

使用场景:API 兼容旧版字段可选、配置项动态生效、审计日志需保留原始输入结构。

立即学习go语言免费学习笔记(深入)”;

MemFree
MemFree

MemFree - 来自知识库和互联网的混合AI搜索,更快获取准确答案

下载
  • 字段类型设为 json.RawMessage,反序列化后检查其长度:len(raw) == 0 表示字段缺失;raw == []byte("null") 表示显式传了 null
  • 后续用 json.Unmarshal(raw, &target) 做二次解析,注意处理错误(比如类型不匹配)
  • 别直接对 json.RawMessage 做比较或打印,它不是字符串;转 string(raw) 仅用于调试
type Config struct {
    Name json.RawMessage `json:"name"`
}
// 解析后:
if len(cfg.Name) == 0 {
    // 字段根本没出现
} else if string(cfg.Name) == "null" {
    // 显式传了 null
} else {
    var name string
    json.Unmarshal(cfg.Name, &name) // 正常解析
}

UnmarshalJSON 方法里手动控制 nil 赋值逻辑

标准 json.Unmarshal 对指针字段的「赋值时机」很保守,有时你需要更细粒度的控制:比如字段为 null 时置 nil,有值时才 new;或者忽略 null 当作缺失处理。

性能影响小,但会增加维护成本;适用于核心模型或需要统一空值语义的场景。

  • 为结构体实现 UnmarshalJSON([]byte) error 方法,在里面用 json.Unmarshal 先解析到 map 或中间结构
  • 检查 key 是否存在、值是否为 json.Null(即 nil),再决定是否 new 指针或保持 nil
  • 别忘了调用 json.Unmarshal 原始字节到具体字段,否则字段不会被填充

嵌套结构体中指针字段的零值陷阱

如果外层结构体字段是指向结构体的指针(如 *User),而 JSON 里该字段是 null,反序列化后它就是 nil —— 这没问题;但如果 JSON 里完全没这个字段,它也还是 nil。两者行为一致,但语义不同。

容易踩的坑:用 if user != nil 判断字段是否存在,结果把「没传」和「传了 null」当成一回事;下游代码 panic 或逻辑错乱。

  • 想区分二者,必须在外层用 json.RawMessage 捕获,或在自定义 UnmarshalJSON 中解析 map[string]json.RawMessage
  • 别依赖指针是否为 nil 来推断业务含义;加注释说明该字段的空值语义(例如:“nil 表示未提供,&User{} 表示提供但为空对象”)
  • 测试时务必覆盖三种 case:字段缺失、字段为 null、字段有有效值
Go 的零值机制和 JSON 反序列化策略是正交的,但组合起来会让空值语义变得模糊。真正难的不是写对代码,而是和上下游约好:这个 nil 到底代表「用户没填」,还是「用户明确清空」,或是「传输出错了」。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

210

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

247

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

356

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

214

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

407

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

490

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

200

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1418

2025.06.17

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

4

2026.03.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 10.1万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号