0

0

JSON 结构体标签错误导致编码异常的解决方案

碧海醫心

碧海醫心

发布时间:2026-01-05 14:27:10

|

150人浏览过

|

来源于php中文网

原创

JSON 结构体标签错误导致编码异常的解决方案

本文详解 gojson 编码失败的根本原因:结构体字段的 `json` 标签语法错误(如误写为 `json:":"text"`),并提供正确写法、完整修复示例及 martini 环境下的最佳实践。

在 Go 中使用 json.Marshal 时,结构体字段的 struct tag 必须严格遵循 json:"key" 的语法格式。你遇到的问题——生成无效 JSON(如 {"time":"...",":":"Привет"} 或空对象 {})——直接源于错误的标签定义:

// ❌ 错误写法(冒号位置错误,引号缺失,语法非法)
Text string `json:":"text"`  // 解析失败,Go 将其视为无效 tag,忽略该字段

该写法实际被 Go 视为 json: 后跟一个未闭合的字符串字面量,导致 struct tag 解析失败,Text 和 User1 字段在序列化时被跳过(默认值为空),而 Time 字段因标签 json:"time" 正确得以保留,但 ":"text" 这类非法 tag 可能触发未定义行为(如字段名被错误映射为 ":")。

✅ 正确写法应为:

type ChatBetweenUsers struct {
    Time  string `json:"time"`
    Text  string `json:"text"`   // 注意:双引号包裹 key,无额外冒号
    User1 string `json:"user1"`
}

此外,原始代码还存在多个工程实践问题,需一并修正:

1. 结构体命名规范

Go 推荐导出(首字母大写)结构体名以支持跨包使用,且符合 PascalCase 风格:

Lovart
Lovart

全球首个AI设计智能体

下载
type ChatBetweenUsers struct { // ✅ 导出 + 驼峰命名
    Time  string `json:"time"`
    Text  string `json:"text"`
    User1 string `json:"user1"`
}

2. 避免全局变量污染与并发风险

time, text, user1 等变量声明在函数外会导致数据竞争。应在循环内声明局部变量:

for rows.Next() {
    var time, text string // ✅ 局部作用域,安全可靠
    if err := rows.Scan(&time, &text); err != nil {
        log.Printf("Scan error: %v", err)
        continue // 而非 Fatal,避免单条错误中断全部响应
    }
    item := ChatBetweenUsers{Time: time, Text: text}
    b, err := json.Marshal(item)
    if err != nil {
        log.Printf("Marshal error: %v", err)
        continue
    }
    buffer.Write(b) // 使用 Write 替代 WriteString(s),更高效
    buffer.WriteByte('\n') // 可选:每条记录换行,便于调试或流式解析
}

3. 返回合法 JSON 数组(推荐)

当前代码拼接多个 JSON 对象(如 {}{})不符合标准 JSON 格式。前端解析会失败。正确做法是构建切片后一次性编码

var messages []ChatBetweenUsers

for rows.Next() {
    var time, text string
    if err := rows.Scan(&time, &text); err != nil {
        log.Printf("Scan failed: %v", err)
        continue
    }
    messages = append(messages, ChatBetweenUsers{
        Time: time,
        Text: text,
    })
}

if err := rows.Err(); err != nil {
    log.Printf("Rows iteration error: %v", err)
    return ""
}

data, err := json.Marshal(messages)
if err != nil {
    log.Printf("Final marshal error: %v", err)
    return ""
}
return string(data) // ✅ 返回标准 JSON 数组:[{"time":"...","text":"..."}, ...]

4. Martini 响应头设置(关键!)

确保返回 JSON 时设置正确的 Content-Type,否则浏览器或客户端可能无法正确解析:

m.Get("/api/messages", func(res http.ResponseWriter) string {
    res.Header().Set("Content-Type", "application/json; charset=utf-8")
    return yourJSONString // 上述生成的合法 JSON
})

总结

  • ? 核心错误:json:":"key" 是非法 struct tag,必须改为 json:"key";
  • ?️ 修复步骤:修正所有字段标签 → 使用导出结构体 → 局部变量扫描 → 构建切片再编码 → 设置 Content-Type;
  • ✅ 最终输出示例:
    [{"time":"13:42:21 11.12.14","text":"Привет"},{"time":"13:42:25 11.12.14","text":"Эй!"}]

遵循以上规范,即可彻底解决 Martini 中 JSON 编码乱码、空对象及格式非法等问题。

相关专题

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

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

406

2023.08.07

json是什么
json是什么

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

531

2023.08.23

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

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

308

2023.10.13

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

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

74

2025.09.10

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

73

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

96

2025.09.18

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

253

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

206

2023.09.04

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

13

2026.01.07

热门下载

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

精品课程

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

共101课时 | 8.2万人学习

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号