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

如何解决 JSON 字符串无法反序列化到嵌套结构体字段的错误

风芳吖_4931

风芳吖_4931

发布时间:2026-11-03 09:10:10

|

357人浏览过

|

来源于php中文网

原创

如何解决 JSON 字符串无法反序列化到嵌套结构体字段的错误

当 JSON 中的 article_type 是字符串(如 "news"),而 Go 结构体中对应字段为自定义结构体 ArticleType 时,会因类型不匹配触发 cannot unmarshal string into Go struct field 错误;可通过实现 json.Unmarshaler 接口,让结构体支持从字符串直接解析。

当 json 中的 `article_type` 是字符串(如 `"news"`),而 go 结构体中对应字段为自定义结构体 `articletype` 时,会因类型不匹配触发 `cannot unmarshal string into go struct field` 错误;可通过实现 `json.unmarshaler` 接口,让结构体支持从字符串直接解析。

在 Go 的 JSON 反序列化过程中,json.Unmarshal 要求 JSON 数据的类型与目标 Go 字段类型严格一致。本例中,JSON 片段提供的是字符串值 "news":

{"article_type":"news"}

但结构体定义为:

ArticleType ArticleType `json:"article_type"`

而 ArticleType 是一个含 ID, Title, CreatedAt 等字段的完整结构体,Go 默认尝试将字符串 "news" 解析为整个结构体——显然失败,抛出 cannot unmarshal string into Go struct field ... of type models.ArticleType。

✅ 正确解法:为 ArticleType 实现 json.Unmarshaler 接口,使其能优雅降级处理字符串输入——即当 JSON 值为字符串时,仅填充 Title 字段,忽略其他字段(后续可结合业务逻辑按需补全 ID 或关联查询)。

以下是推荐实现:

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

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

下载
func (a *ArticleType) UnmarshalJSON(data []byte) error {
    // 去除首尾引号(json.Unmarshal 已处理转义,直接 string(data) 会带双引号)
    s := strings.Trim(string(data), `"`)
    a.Title = s
    return nil
}

⚠️ 注意:上述实现依赖 strings 包,需在文件顶部导入:

import "strings"

完整可运行示例(精简版):

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() {
    str := []byte(`[{"created_at":1486579331,"updated_at":1486579331,"article_type":"news"}]`)
    var articles []Article
    if err := json.Unmarshal(str, &articles); err != nil {
        panic(err)
    }
    fmt.Printf("%+v\n", articles[0].ArticleType) // 输出:{ID:0 Title:"news"}
}

? 补充建议:

  • 若需进一步支持数据库写入(如自动创建或查找 ArticleType 记录),应在业务层调用 GORM 查询或 Upsert 逻辑,而非在 UnmarshalJSON 中耦合 ORM 操作;
  • 如需同时兼容 JSON 对象(如 {"title":"news","id":1})和字符串两种格式,UnmarshalJSON 内部应先尝试解析为字符串,失败后再解析为对象(使用 json.RawMessage 分两阶段处理);
  • 此方案保持了结构体定义的完整性,也避免了引入额外字段(如 ArticleTypeTitle string)破坏领域模型一致性。

通过接口定制反序列化行为,既符合 Go 的惯用法,又实现了灵活、可维护的数据绑定逻辑。

热门AI工具

更多
DeepSeek

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

讯飞智作

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

切问学术

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UP简历
UP简历 Hot

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

豆包大模型

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

WorkBuddy

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

PixTV
PixTV Hot

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

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

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

2235

2023.08.07

json是什么
json是什么

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

3582

2023.08.23

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

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

1196

2023.10.13

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

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

4139

2025.09.10

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

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

5114

2025.06.09

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

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

5291

2025.07.04

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

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

3209

2023.09.06

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

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

6407

2023.09.25

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

0

2026.11.03

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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