如何解决 JSON 字符串字段反序列化到嵌套结构体时的类型不匹配错误

老伟姑娘_7234

老伟姑娘_7234

2026-11-03

703人浏览

原创

如何解决 JSON 字符串字段反序列化到嵌套结构体时的类型不匹配错误

当 JSON 中的 article_type 是字符串(如 "news"),而 Go 结构体中对应字段是自定义结构体 ArticleType 时,json.Unmarshal 会因类型不兼容报错;可通过实现 json.Unmarshaler 接口,让结构体支持从字符串直接解析。

当 json 中的 `article_type` 是字符串(如 `"news"`),而 go 结构体中对应字段是自定义结构体 `articletype` 时,`json.unmarshal` 会因类型不兼容报错;可通过实现 `json.unmarshaler` 接口,让结构体支持从字符串直接解析。

在 Go 的 JSON 反序列化过程中,若目标字段类型为自定义结构体(如 ArticleType),但源 JSON 提供的是简单字符串(如 "news"),标准 json.Unmarshal 无法自动将字符串映射到结构体字段,从而触发典型错误:
json: cannot unmarshal string into Go struct field Article.article_type of type models.ArticleType

根本原因在于:Go 的 encoding/json 包默认仅支持「同构映射」——即 JSON 对象 → 结构体、JSON 字符串 → string、JSON 数字 → int/float 等。而此处期望的是「异构映射」:JSON 字符串 → 结构体(且仅填充其 Title 字段)。

✅ 正确解法:为 ArticleType 实现 json.Unmarshaler 接口:

func (a *ArticleType) UnmarshalJSON(data []byte) error {
    // 去除首尾引号(json.Unmarshal 传入的字符串字面量带双引号)
    s := strings.Trim(string(data), `"`)
    a.Title = s
    return nil
}

⚠️ 注意事项:

jm-jsjkxyjs02-zlm-405
jm-jsjkxyjs02-zlm-405

使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。

下载
  • 必须使用指针接收者(*ArticleType),否则接口实现无效;
  • 需手动处理 JSON 字符串的引号包裹("news" → news),推荐用 strings.Trim(s, "\"");
  • 若后续需双向序列化(即 json.Marshal 时也输出字符串),应同时实现 json.Marshaler;
  • 此方案适用于「单字段轻量映射」场景;若 ArticleType 在业务中还需关联 ID 或数据库查询,建议分离「传输层 DTO」与「领域模型」,避免语义混淆。

完整可运行示例(含修复后代码):

package main

import (
    "encoding/json"
    "fmt"
    "strings"
)

type ArticleType struct {
    ID        uint   `json:"id"`
    Title     string `json:"title"`
}

func (a *ArticleType) UnmarshalJSON(data []byte) error {
    s := strings.Trim(string(data), `"`)
    a.Title = s
    return nil
}

type Article struct {
    CreatedAt   int         `json:"created_at"`
    UpdatedAt   int         `json:"updated_at"`
    ArticleType ArticleType `json:"article_type"`
}

func main() {
    data := []byte(`[{"created_at":1486579331,"updated_at":1486579331,"article_type":"news"}]`)
    var articles []Article
    if err := json.Unmarshal(data, &articles); err != nil {
        panic(err)
    }
    fmt.Printf("%+v\n", articles[0].ArticleType) // 输出:{ID:0 Title:"news"}
}

总结:该问题本质是 JSON 类型与 Go 类型契约不一致。通过定制 UnmarshalJSON 方法,我们赋予结构体灵活的反序列化能力,既保持了 API 兼容性(输入仍是简洁字符串),又满足了领域模型的结构需求。这是 Go 中处理「语义简写 JSON」的惯用且高效模式。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.06.09

5114

18

golang结构体方法
golang结构体方法

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

2025.07.04

5291

25

Go中Type关键字的用法
Go中Type关键字的用法

Go中Type关键字的用法有定义新的类型别名或者创建新的结构体类型。本专题为大家提供Go相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.06

3209

5

go怎么实现链表
go怎么实现链表

go通过定义一个节点结构体、定义一个链表结构体、定义一些方法来操作链表、实现一个方法来删除链表中的一个节点和实现一个方法来打印链表中的所有节点的方法实现链表。

2023.09.25

6407

6

go语言编程软件有哪些
go语言编程软件有哪些

go语言编程软件有Go编译器、Go开发环境、Go包管理器、Go测试框架、Go文档生成器、Go代码质量工具和Go性能分析工具等。本专题为大家提供go语言相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.13

762

5

0基础如何学go语言
0基础如何学go语言

0基础学习Go语言需要分阶段进行,从基础知识到实践项目,逐步深入。php中文网给大家带来了go语言相关的教程以及文章,欢迎大家前来学习。

2023.10.26

8185

20

Go语言实现运算符重载有哪些方法
Go语言实现运算符重载有哪些方法

Go语言不支持运算符重载,但可以通过一些方法来模拟运算符重载的效果。使用函数重载来模拟运算符重载,可以为不同的类型定义不同的函数,以实现类似运算符重载的效果,通过函数重载,可以为不同的类型实现不同的操作。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

3016

5

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

3264

5

go语言开发工具大全
go语言开发工具大全

本专题整合了go语言开发工具大全,想了解更多相关详细内容,请阅读下面的文章。

2025.06.11

7199

12

热门下载

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

精品课程

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

共101课时 | 21.3万人学习

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

共39课时 | 4.9万人学习