
本文详解 go 中 json 编码失败的根本原因:结构体字段的 `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 风格:
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 编码乱码、空对象及格式非法等问题。










