讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

如何在Golang中处理JSON字段缺失_Golangjson解析字段校验方法

落明大大_7617

落明大大_7617

发布时间:2026-01-01 15:19:02

|

432人浏览过

|

来源于php中文网

原创

json.Unmarshal字段缺失时不报错,将结构体字段设为零值;可用指针类型判nil、json.RawMessage手动检查或自定义UnmarshalJSON实现精准追踪。

如何在golang中处理json字段缺失_golangjson解析字段校验方法

JSON字段缺失时 json.Unmarshal 默认行为是什么

Go 的 json.Unmarshal 在遇到 JSON 中缺少某个字段时,**不会报错**,而是将对应结构体字段设为零值(0、""、nil、false 等)。这容易掩盖数据不完整问题,尤其在 API 请求或配置解析场景中导致静默失败。

例如,若结构体定义了 ID int,但 JSON 中没传 "id",ID 就变成 0 —— 你无法区分这是“用户真传了 0”,还是“字段根本没传”。

  • 零值覆盖不可逆,原始缺失状态丢失
  • 没有内置开关让 Unmarshal 在字段缺失时报错
  • omitempty 标签只影响序列化(Marshal),对反序列化无作用

用指针字段 + nil 判断识别字段是否缺失

最直接可控的方式:把需要校验是否存在的字段声明为指针类型。JSON 解析器只有在字段存在时才会分配内存并赋值;缺失时保持 nil。

Expanso yaml-to-json
Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载
type User struct {
    ID   *int    `json:"id"`
    Name *string `json:"name"`
    Age  *int    `json:"age"`
}

// 示例 JSON: {"name": "Alice"} → ID 和 Age 为 nil,Name 指向 "Alice"
  • 检查 u.ID == nil 即可确认 "id" 字段未提供
  • 注意:指针字段需手动解引用(如 *u.ID),且要先判空避免 panic
  • 适合必填字段校验,但会让结构体变“重”,尤其嵌套多层时指针易出错

用 json.RawMessage 延迟解析 + 手动字段存在性检查

当需要统一判断多个字段是否存在,或字段类型动态(比如可能是 string 或 number),可用 json.RawMessage 先原样捕获字节,再按需解析并检查 key 是否存在。

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

type Payload struct {
    Data json.RawMessage `json:"data"`
}

var p Payload
if err := json.Unmarshal(b, &p); err != nil {
    return err
}

// 转成 map[string]json.RawMessage 检查 key
var m map[string]json.RawMessage
if err := json.Unmarshal(p.Data, &m); err != nil {
    return err
}
if _, ok := m["timeout"]; !ok {
    return fmt.Errorf("missing required field: timeout")
}
  • 能精确知道哪些 key 存在/不存在,不依赖零值语义
  • 适合做前置校验(如中间件里统一拦截缺失字段)
  • 性能略低(两次 Unmarshal),且需额外处理类型转换逻辑

自定义 UnmarshalJSON 实现字段存在性钩子

对关键结构体,可实现 UnmarshalJSON 方法,在解析过程中记录哪些字段被设置。配合私有标记字段(如 seenID bool)完成精准追踪。

type User struct {
    ID    int  `json:"id"`
    Name  string `json:"name"`
    seenID bool
    seenName bool
}

func (u *User) UnmarshalJSON(data []byte) error {
    type Alias User // 防止无限递归
    aux := &struct {
        ID   *int    `json:"id"`
        Name *string `json:"name"`
        *Alias
    }{
        Alias: (*Alias)(u),
    }
    if err := json.Unmarshal(data, &aux); err != nil {
        return err
    }
    if aux.ID != nil {
        u.seenID = true
        u.ID = *aux.ID
    }
    if aux.Name != nil {
        u.seenName = true
        u.Name = *aux.Name
    }
    return nil
}
  • 保留原始字段类型(非指针),同时获得字段是否被设置的能力
  • 代码量稍多,但复用性和类型安全更好
  • 注意别漏掉所有字段,否则可能误判为“未设置”
字段缺失不是格式错误,所以标准库不报错;真正难的是在保持简洁和类型安全之间选边——指针最省事,RawMessage 最灵活,自定义 UnmarshalJSON 最精确。实际项目里,建议优先用指针字段,仅在必要时才上更重的方案。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

539

2024.02.23

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

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

616

2024.02.23

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

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

1296

2024.02.23

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

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

811

2024.03.05

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

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

1886

2024.05.21

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

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

5414

2025.06.09

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

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

2514

2025.06.10

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

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

4366

2025.06.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

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

精品课程

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

共101课时 | 21.3万人学习

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

共39课时 | 4.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn