本文详解 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"}
] 
