讲师中心 微信公众号
AI工具推荐 视频效率加速

Go语言中JSON序列化失败:结构体字段未导出导致空对象问题

老雪大大_6812

老雪大大_6812

发布时间:2026-01-18 14:35:02

|

821人浏览过

|

来源于php中文网

原创

Go语言中JSON序列化失败:结构体字段未导出导致空对象问题

go语言中使用json.marshal序列化结构体时,若字段名首字母小写(未导出),则无法被json包访问,导致生成空对象(如{});必须将字段改为大写首字母并配合json标签才能正确序列化。

在Go中,JSON编码器(encoding/json)仅能访问导出字段(即首字母大写的字段)。这是Go语言的可见性规则决定的:小写开头的字段属于包内私有,外部包(包括标准库中的json)无法反射读取其值,因此序列化结果中对应字段被忽略,最终生成空JSON对象{}。

例如,原始代码中定义的SpanInfo结构体:

type SpanInfo struct {
    imsi string        // ❌ 小写 → 未导出 → JSON中不可见
    network string      // ❌ 同上
    network_status string
    signal_quality int
    slot int
    state string
}

尽管运行时gatewayInfo切片包含有效数据(日志中可见Polling content: [{...} {...}]),但json.Marshal因无法访问任何字段,只能为每个SpanInfo生成空对象{}。

✅ 正确做法是:

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

Comprehensive Three.js 3D graphics reference
Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载
  1. 将所有字段名首字母大写,使其导出;
  2. 通过json标签指定JSON键名(保持小写风格,符合API惯例);
  3. 可选:为整数/布尔字段添加omitempty等修饰符提升健壮性。

修正后的结构体定义如下:

type SpanInfo struct {
    IMSI         string `json:"imsi"`
    Network      string `json:"network"`
    NetworkStatus string `json:"network_status"`
    SignalQuality int    `json:"signal_quality"`
    Slot         int    `json:"slot"`
    State        string `json:"state"`
}

type GatewayInfo []SpanInfo // 切片类型无需修改,仍可直接Marshal

完整使用示例:

func getGatewayInfo(spans []SpanInfo) GatewayInfo {
    return GatewayInfo(spans)
}

func main() {
    spans := []SpanInfo{
        {IMSI: "652020105829193", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 17, Slot: 2, State: "active"},
        {IMSI: "652020105829194", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 16, Slot: 3, State: "active"},
    }

    gatewayInfo := getGatewayInfo(spans)
    jsonInfo, err := json.Marshal(gatewayInfo)
    if err != nil {
        log.Fatal("JSON marshal error:", err)
    }

    log.Printf("jsonInfo: %s", jsonInfo)
    // 输出: [{"imsi":"652020105829193","network":"20801",...},{"imsi":"652020105829194",...}]
}

⚠️ 注意事项:

  • 若字段可能为空值(如""、0、nil),可追加omitempty标签(如json:"imsi,omitempty")避免冗余键;
  • 不要混淆json标签与字段名大小写——标签控制输出键名,首字母大小写控制是否可导出;
  • 使用json.MarshalIndent可生成格式化JSON,便于调试;
  • 始终检查json.Marshal返回的err,避免静默失败。

遵循导出规则是Go中JSON序列化的基础前提,也是与其他序列化格式(如XML、Gob)共通的设计约束。

热门AI工具

更多
WorkBuddy

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

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

讯飞智作

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

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

UP简历
UP简历 Hot

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

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1975

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2682

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

936

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2999

2025.09.10

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4004

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

5117

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2282

2024.11.28

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

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

3994

2025.06.09

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

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

共101课时 | 20.6万人学习

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

共39课时 | 4.7万人学习

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

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