Go 的 json 包仅序列化导出（首字母大写）字段；若嵌套结构中存在未导出字段（如 username string），则对应 JSON 键将为空对象或被忽略，导致数据丢失。
go 的 `json` 包仅序列化导出（首字母大写）字段；若嵌套结构中存在未导出字段（如 `username string`），则对应 json 键将为空对象或被忽略，导致数据丢失。
在 Go 中使用 json.Marshal 或 json.NewEncoder 进行序列化时，结构体字段的可见性（exported vs unexported）直接决定其是否参与 JSON 编码。这是 Go 语言设计的核心原则之一：只有首字母大写的字段才是导出的（public），才能被外部包（包括标准库 encoding/json）访问和序列化。
回顾你提供的代码，问题根源非常明确：
? 根本原因分析
-
User 结构体字段全部未导出：
User struct { username string `json:"username"` // ❌ 小写开头 → 不导出 → JSON 中为 `{}`（空对象） token string `json:"-"` // ❌ 同样不导出，且被显式忽略 }即使添加了 json:"username" 标签，json 包也无法读取 username 字段的值——因为该字段对 encoding/json 包不可见。结果就是 users: [{}, {}]。
-
Messages 为空的原因：
Messages []Message
你定义的是类型别名 type Messages []Message，但 Chatroom.Messages 字段本身是未导出的（小写 messages？等等——注意你实际定义的是：
Messages Messages `json:"messages"` // ✅ 字段名是 `Messages`（大写 M），所以导出！
但关键在于：Message 结构体中的字段是否全部导出？
检查你的 Message：Message struct { Token string `json:"token,omitempty"` Type string `json:"type"` Author string `json:"author"` Content string `json:"content"` Chatroom string `json:"chatroom"` }✅ 全部字段均为大写开头，因此 Message 本身可被正确序列化。
那为何 messages 数组为空？
→ 极可能是因为 Chatroom.Messages 字段实际未被正确赋值或初始化为零值，或 append 操作作用于错误变量。但更隐蔽的常见原因是：你定义了 type Messages []Message，却在 Chatroom 中声明为：Messages Messages `json:"messages"`
这本身合法，但需确保 Messages 类型别名不影响底层切片行为。真正风险点在于：若你在某处误用 var msgs Messages 但未赋值给 c.Messages，或 append 返回值未重新赋给 c.Messages，就会导致空数组。
✅ 正确写法（注意 = 赋值）：
c.Messages = append(c.Messages, message) // ✅ 必须重新赋值给结构体字段
✅ 修复方案：统一导出所有需序列化的字段
// ✅ 修正后的结构体（关键：首字母大写 + 显式 JSON 标签）
type User struct {
Username string `json:"username"` // ✅ 导出字段
Token string `json:"token,omitempty"` // ✅ 可选导出字段
}
type Message struct {
Token string `json:"token,omitempty"`
Type string `json:"type"`
Author string `json:"author"`
Content string `json:"content"`
Chatroom string `json:"chatroom"`
}
type Messages []Message // 类型别名保持不变，但元素类型已修复
type Chatroom struct {
Name string `json:"name"`
Users []User `json:"users"`
Messages Messages `json:"messages"`
Hub *WsHub `json:"-"` // ✅ 正确忽略私有字段
}
type ChatroomData struct {
Token string `json:"token"`
Chatroom *Chatroom `json:"chatroom"`
}? 额外建议与最佳实践
- 启用 json 包的严格模式（可选）：使用 json.Encoder.SetEscapeHTML(false) 避免转义，但非必需；
- 调试技巧：在序列化前用 fmt.Printf("%+v\n", chatroom) 打印结构体，确认字段值和可见性；
- 避免嵌套别名陷阱：type Messages []Message 是安全的，但不要嵌套过深（如 type MsgList []Messages），易引发混淆；
- 考虑使用 omitempty 谨慎：Token stringjson:"token,omitempty`在值为空字符串时会省略该键，若前端依赖此字段存在，应改用指针*string` 或保留空字符串。
✅ 验证修复效果
修复后，SendChatroomData 发送的 JSON 将正确包含用户信息与消息列表：
{
"token": "a638ed3ba0c30ba3d0810fc79e12a50a",
"chatroom": {
"name": "main",
"users": [
{"username": "alice", "token": "tkn1"},
{"username": "bob", "token": "tkn2"}
],
"messages": [
{"type": "message", "author": "alice", "content": "Hello!", "chatroom": "main"},
{"type": "message", "author": "bob", "content": "Hi there!", "chatroom": "main"}
]
}
}总结：Go 的 JSON 序列化不是“标签驱动”的魔法，而是基于导出规则的反射机制。始终确保待序列化的字段首字母大写，并通过 go vet 或 IDE 检查未导出字段的误用——这是写出健壮 API 响应的基础。
