JSON 字段标签语法错误导致 Martini 返回无效 JSON 数据

本文详解 go 中结构体 json 标签的正确写法，指出 `json:":"text"` 这类常见语法错误，并提供修复方案、完整可运行示例及 martini 环境下的最佳实践。

在使用 Martini（或任何基于 Go 的 Web 框架）返回数据库查询结果为 JSON 时，结构体字段的 json 标签语法必须严格遵循 Go 的结构体标签规范。你遇到的问题——如 {"time":"13:42:21 11.12.14",":":"Привет"} 或空对象 {}——根本原因在于 JSON 标签格式错误：json:":"text" 是非法语法，Go 解析器会将其视为一个名为 ":" 的键（即字面量冒号），而非 "text" 字段名，从而导致序列化失败或字段被忽略。

✅ 正确的 JSON 标签语法

JSON 结构体标签应为：

FieldName Type `json:"key_name"`

其中：

• json: 是标签键；
• "key_name" 是双引号包裹的合法字符串（可选后缀如 ,omitempty）；
• ❌ 错误写法：json:":"text"（冒号在引号外，破坏语法结构）；
• ✅ 正确写法：json:"text" 或 json:"text,omitempty"。

因此，你的两个结构体均需修正：

type chatbetweenusers struct {
    Time  string `json:"time"`  // ✅ 正确
    Text  string `json:"text"`  // ✅ 替换 json:":"text"
    User1 string `json:"user1"` // ✅ 替换 json:":"user1"
}

? 完整修复后的 Martini 处理示例

以下是一个精简、健壮的处理逻辑（适配 Martini 的 martini.Context 或直接作为 handler）：

import (
    "bytes"
    "database/sql"
    "encoding/json"
    "log"
    _ "github.com/mattn/go-sqlite3"
)

func getChatMessages() string {
    db, err := sql.Open("sqlite3", "./database.db")
    if err != nil {
        log.Fatal("DB open failed:", err)
    }
    defer db.Close()

    rows, err := db.Query("SELECT time, text, user1 FROM messages")
    if err != nil {
        log.Fatal("Query failed:", err)
    }
    defer rows.Close()

    var messages []chatbetweenusers // 使用切片收集全部数据
    for rows.Next() {
        var time, text, user1 string
        if err := rows.Scan(&time, &text, &user1); err != nil {
            log.Fatal("Scan failed:", err)
        }
        messages = append(messages, chatbetweenusers{
            Time:  time,
            Text:  text,
            User1: user1,
        })
    }

    // 一次性序列化整个切片 → 得到标准 JSON 数组：[{"time":"...","text":"..."}, ...]
    b, err := json.Marshal(messages)
    if err != nil {
        log.Fatal("JSON marshal failed:", err)
    }
    return string(b)
}

// 对应结构体（注意：字段首字母必须大写才能导出！）
type chatbetweenusers struct {
    Time  string `json:"time"`
    Text  string `json:"text"`
    User1 string `json:"user1"`
}

? 关键改进说明： 使用 []chatbetweenusers 切片统一收集数据，再调用 json.Marshal() 一次生成合法 JSON 数组（而非拼接多个独立对象，避免 {"a":1}{"b":2} 这类非法格式）； 避免手动 buffer.WriteString(s) 拼接 JSON 字符串——这会产生非标准、无法被前端 JSON.parse() 解析的碎片化输出； 所有结构体字段名首字母大写（如 Time, Text），确保可被 json 包导出（小写字段会被忽略）。

⚠️ 注意事项与最佳实践

• 不要拼接 JSON 字符串：HTTP 响应应返回单一、格式正确的 JSON（如 [{...}, {...}] 或 {"data":[...]}），而非多个 {...}{...}。
• 检查 SQL 查询列顺序与 Scan() 参数顺序是否一致，否则会导致字段错位或 panic。
• 始终校验 rows.Err()（在循环结束后）以捕获 Scan 阶段未发现的错误：

  if err := rows.Err(); err != nil {
      log.Fatal("Row iteration error:", err)
  }

• 在 Martini 中，建议通过 render.JSON(200, messages)（配合 martini-contrib/render）自动处理 Content-Type 和序列化，比手动 return string(b) 更安全。

✅ 总结

JSON 序列化异常的根源几乎总是结构体标签语法错误或手动拼接 JSON 导致的格式不合法。牢记：json:"field_name" 是唯一正确形式；优先使用切片 + 一次 json.Marshal() 生成标准 JSON；并确保结构体字段可导出（大写首字母）。修复后，你的 API 将稳定返回如下合规响应：

[
  {"time":"13:42:21 11.12.14","text":"Привет","user1":"Alice"},
  {"time":"13:42:25 11.12.14","text":"Эй!","user1":"Bob"}
]