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

本文详解 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 编码乱码、空对象及格式非法等问题。