0

0

如何解决 golang 中的 “cannot unmarshal…” 错误?

WBOY

WBOY

发布时间:2023-06-24 20:01:59

|

6902人浏览过

|

来源于php中文网

原创

golang 的开发过程中,我们经常会使用 json 来进行数据交换和序列化。然而,当我们尝试将 json 数据反序列化成结构体时,有时候会遇到 “cannot unmarshal…” 的错误。这个错误消息比较晦涩,不容易理解,让人无从下手。本篇文章将帮助你理解这个错误的原因,并提供几种解决办法。

解决办法一:检查结构体成员变量的类型

“cannot unmarshal…” 错误通常是由于 JSON 字符串中的值与结构体成员变量的类型不匹配所引起的。为了避免这种错误,我们应该确保在声明结构体时,每个成员变量的类型都能与 JSON 中的对应值匹配。

例如,我们定义了如下结构体:

新快购物系统
新快购物系统

新快购物系统是集合目前网络所有购物系统为参考而开发,不管从速度还是安全我们都努力做到最好,此版虽为免费版但是功能齐全,无任何错误,特点有:专业的、全面的电子商务解决方案,使您可以轻松实现网上销售;自助式开放性的数据平台,为您提供充满个性化的设计空间;功能全面、操作简单的远程管理系统,让您在家中也可实现正常销售管理;严谨实用的全新商品数据库,便于查询搜索您的商品。

下载
type Person struct {
    Name string
    Age  int
}

如果我们尝试将下面的 JSON 反序列化成结构体,就会遇到 “cannot unmarshal…” 错误:

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

{
    "Name": "Lucy",
    "Age": "28"
}

这是因为 JSON 中的 Age 值类型是字符串,不能与结构体中的 Age 成员变量类型 int 匹配。我们需要将 Age 的类型定义为 string,才能正确地反序列化 JSON 数据。

解决办法二:检查结构体成员变量的标签

通常情况下,如果我们在结构体成员变量中为字段定义了标签(tag),那么标签信息会在反序列化时对 JSON 数据进行指导,用于识别每个字段的名称及其他细节。因此,在进行 JSON 反序列化时,如果标签信息与 JSON 数据中的属性名称不匹配,也可能会导致这个错误的出现。

例如,我们定义了如下结构体:

type Person struct {
    Name string `json:"PersonName"`
    Age  int    `json:"PersonAge"`
}

如果我们尝试将下面的 JSON 反序列化成结构体,同样会遇到 “cannot unmarshal…” 错误:

{
    "Name": "Lucy",
    "Age": 28
}

这是因为我们在结构体中给 Name 和 Age 两个字段定义了标签,而标签中所定义的字段名与 JSON 数据中的属性名称不一致。因此,我们需要将 JSON 数据中的属性名修改为结构体中所定义的标签名,才能正确的反序列化。

解决办法三:使用 golang 自带的 json 包进行注解

另一种方法是使用 golang 自带的 json 包,通过注解的方式防止出现“cannot unmarshal…”错误。该方法需要我们在定义结构体时,为每个字段添加 json 标签,如下所示:

type Person struct {
    Name string `json:"name"`
    Age int `json:"age"`
}

在进行 JSON 反序列化时,我们需要在代码中使用 json.Unmarshal 方法,并将 JSON 数据作为输入。这样就可以正确的反序列化 JSON 数据了,例如:

p := &Person{}
jsonData := []byte(`{"name":"John","age":18}`)
err := json.Unmarshal(jsonData, p)
if err != nil {
    fmt.Println("Unmarshal error: ", err)
}
fmt.Printf("Name: %s, Age: %d", p.Name, p.Age)

总结

在大多数情况下,“cannot unmarshal…” 错误通常是由于 JSON 数据中的类型与结构体成员变量的类型不匹配或者是标签信息与 JSON 数据中的属性名称不匹配所引起的。通过对这些问题进行仔细的检查,我们就可以避免这个错误的出现。如果你想更好地解决这个错误,请使用 Golang 自带的 json 包进行注解管理。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
go语言 注释编码
go语言 注释编码

本专题整合了go语言注释、注释规范等等内容,阅读专题下面的文章了解更多详细内容。

2

2026.01.31

go语言 math包
go语言 math包

本专题整合了go语言math包相关内容,阅读专题下面的文章了解更多详细内容。

1

2026.01.31

go语言输入函数
go语言输入函数

本专题整合了go语言输入相关教程内容,阅读专题下面的文章了解更多详细内容。

1

2026.01.31

golang 循环遍历
golang 循环遍历

本专题整合了golang循环遍历相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.31

Golang人工智能合集
Golang人工智能合集

本专题整合了Golang人工智能相关内容,阅读专题下面的文章了解更多详细内容。

1

2026.01.31

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

76

2026.01.31

高干文在线阅读网站大全
高干文在线阅读网站大全

汇集热门1v1高干文免费阅读资源,涵盖都市言情、京味大院、军旅高干等经典题材,情节紧凑、人物鲜明。阅读专题下面的文章了解更多详细内容。

73

2026.01.31

无需付费的漫画app大全
无需付费的漫画app大全

想找真正免费又无套路的漫画App?本合集精选多款永久免费、资源丰富、无广告干扰的优质漫画应用,涵盖国漫、日漫、韩漫及经典老番,满足各类阅读需求。阅读专题下面的文章了解更多详细内容。

67

2026.01.31

漫画免费在线观看地址大全
漫画免费在线观看地址大全

想找免费又资源丰富的漫画网站?本合集精选2025-2026年热门平台,涵盖国漫、日漫、韩漫等多类型作品,支持高清流畅阅读与离线缓存。阅读专题下面的文章了解更多详细内容。

19

2026.01.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

mysql8主从复制原理底层详解
mysql8主从复制原理底层详解

共1课时 | 546人学习

apipost极速入门
apipost极速入门

共6课时 | 0.5万人学习

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

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