0

0

如何使用Golang测试JSON序列化与反序列化_Golang encoding/json序列化测试方法

P粉602998670

P粉602998670

发布时间:2026-01-02 17:46:02

|

100人浏览过

|

来源于php中文网

原创

JSON测试易漏边界问题,因默认忽略未导出字段、静默跳过类型不匹配、nil切片/映射行为不一致且不校验标签拼写;需覆盖零值与nil区分、嵌套round-trip、错误输入健壮性、标签副作用四类用例。

如何使用golang测试json序列化与反序列化_golang encoding/json序列化测试方法

为什么 json.Marshaljson.Unmarshal 测试容易漏掉边界问题

因为 Go 的 encoding/json 默认忽略未导出字段、静默跳过类型不匹配、对 nil 切片/映射行为不一致,且不校验结构体标签拼写错误。你写的测试如果只覆盖“字段值正确”,很可能在真实场景中因空指针、零值覆盖、嵌套结构丢失而崩溃。

  • 未导出字段(首字母小写)不会被序列化,但反序列化时也不会报错——它只是默默忽略
  • json:"name,omitempty" 在字段为零值时完全不输出,但反序列化后该字段仍会被设为零值,可能掩盖业务逻辑误判
  • 如果结构体字段类型是 *string 但 JSON 给的是字符串字面量,json.Unmarshal 会失败并返回 json.UnmarshalTypeError,但很多测试没检查 error
  • 嵌套结构体中某一层字段名拼错(比如 json:"user_id" 写成 json:"uesr_id"),反序列化后对应字段保持 nil 或零值,无提示

必须覆盖的 4 类测试用例(含可直接复用的断言)

不要只测“能跑通”,要验证行为是否符合预期。以下用例基于标准 testing 包,无需额外依赖:

  • 零值与 nil 的区分:定义字段为 *string[]int,分别测试 JSON 中缺失字段、显式 null、空数组 [] 的反序列化结果
  • 嵌套结构的 round-trip 完整性:先 json.Marshaljson.Unmarshal,用 reflect.DeepEqual 比较原始值和还原值(注意:time.Time 等需单独处理)
  • 错误输入的健壮性:传入非法 JSON 字符串(如 "{key: 1}" 缺少引号)、类型错位(数字字段传字符串)、字段超长等,确认返回非 nil error
  • 结构体标签的副作用:故意把 json:"id,string" 加在非数字字段上,或给 int 字段加 string tag 后传入 JSON 字符串,验证是否按预期转换或报错

一个易忽略但关键的测试点:json.RawMessage 的延迟解析

当结构体中某字段类型为 json.RawMessage,它会原样保存 JSON 字节而不解析。这常用于兼容可变结构或避免重复解析,但测试时容易忘记验证它的字节内容是否与原始输入一致——尤其是经过多次 Marshal/Unmarshal 后可能被格式化或截断。

魔术橡皮擦
魔术橡皮擦

智能擦除、填补背景内容

下载
type Payload struct {
    ID     int
    Data   json.RawMessage `json:"data"`
}
raw := []byte(`{"ID":1,"data":{"x":1,"y":2}}`)
var p Payload
err := json.Unmarshal(raw, &p)
if err != nil {
    t.Fatal(err)
}
// 必须比较字节,不能用 string(p.Data) == `{"x":1,"y":2}` —— 因为 marshal 可能重排键顺序
if !bytes.Equal(p.Data, []byte(`{"x":1,"y":2}`)) {
    t.Error("RawMessage content changed")
}

如何验证自定义 MarshalJSON/UnmarshalJSON 方法是否生效

实现这两个方法后,标准 json.Marshal / json.Unmarshal 会自动调用它们,但测试时若只构造结构体再序列化,可能误以为逻辑正常,实际却因方法内部 panic 或返回错误字节而失效。

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

  • MarshalJSON 中故意返回 nil, errors.New("test"),确认外部调用得到非 nil error
  • UnmarshalJSON 中接收非法 JSON(如 []byte("invalid")),检查是否返回预期 error 类型
  • 使用 json.Compact 对比输出字节,避免空格/换行干扰判断;不要依赖 fmt.Sprintf("%s", out) 做字符串比较
  • 如果方法中调用了 json.Marshal 处理子字段,记得测试递归深度过大时是否会溢出(尤其在循环引用场景)
结构体字段的零值、nil、空切片、json.RawMessage 字节一致性、自定义方法的 error 路径——这些地方不写具体断言就等于没测。

相关专题

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

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

174

2024.02.23

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

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

225

2024.02.23

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

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

335

2024.02.23

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

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

206

2024.03.05

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

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

388

2024.05.21

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

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

194

2025.06.09

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

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

189

2025.06.10

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

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

191

2025.06.17

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

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

精品课程

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

共101课时 | 8.1万人学习

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

共39课时 | 3.1万人学习

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

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