Go 的 json 包默认仅序列化导出（首字母大写）字段；若结构体中嵌套的字段（如 User.username、Messages 切片元素）未导出，将被忽略，导致 JSON 输出中对应键为空或缺失。
go 的 `json` 包默认仅序列化导出（首字母大写）字段；若结构体中嵌套的字段（如 `user.username`、`messages` 切片元素）未导出，将被忽略，导致 json 输出中对应键为空或缺失。
在 Go 中，JSON 编码器（json.Marshal / json.NewEncoder）遵循严格的导出性规则：只有首字母大写的字段（即导出字段）才能被反射机制访问并序列化为 JSON。而你的代码中存在多个关键非导出字段，直接导致嵌套数据“消失”。
? 问题定位与修复
✅ 1. User 结构体字段未导出（已明确）
User struct {
username string `json:"username"` // ❌ 小写 → 非导出 → JSON 忽略
token string `json:"-"`
}→ 修复：改为大写首字母，并保留 JSON 标签：
type User struct {
Username string `json:"username"`
Token string `json:"-"` // 若需隐藏，仍可保留 "-"
}✅ 2. Messages 类型别名未导出（隐性陷阱）
你定义了：
type Messages []Message
虽然 Message 是导出类型，但 Messages 本身是类型别名，且未显式导出（type Messages 首字母小写）。更重要的是：Messages 作为字段出现在 Chatroom 中：
Messages Messages `json:"messages"`
→ 此处 Messages 是一个未导出的自定义切片类型，其底层虽为 []Message，但 json 包在处理自定义类型时，会尝试调用其 MarshalJSON 方法（若未实现），或退回到反射——而未导出类型无法被反射遍历元素，最终导致空数组 []。
✅ 推荐修复方式（二选一）：
-
方案 A（推荐）：直接使用导出的切片类型，避免别名
type Chatroom struct { Name string `json:"name"` Users []User `json:"users"` Messages []Message `json:"messages"` // ✅ 直接用 []Message，无需 Messages 别名 Hub *WsHub `json:"-"` } -
方案 B：导出 Messages 类型并确保元素可序列化
type Messages []Message // ✅ 改为 type Messages []Message（首字母大写） // 同时确保 Message 所有字段均导出（见下文）
✅ 3. Message 字段全部导出（验证必要）
你已正确定义：
type Message struct {
Token string `json:"token,omitempty"`
Type string `json:"type"`
Author string `json:"author"`
Content string `json:"content"`
Chatroom string `json:"chatroom"`
}✅ 所有字段均为大写开头，符合导出要求，无需修改。
✅ 4. ChatroomData 和 Chatroom 字段检查
type ChatroomData struct {
Token string `json:"token"`
Chatroom *Chatroom `json:"chatroom"` // ✅ Chatroom 是导出类型，且其字段均已修正
}
type Chatroom struct {
Name string `json:"name"`
Users []User `json:"users"`
Messages []Message `json:"messages"` // ✅ 已按方案 A 修改
Hub *WsHub `json:"-"` // ✅ 正确忽略私有字段
}? 验证示例
修正后，调用 json.NewEncoder(w).Encode(&chatroomData) 将输出完整嵌套数据：
{
"token": "a638ed3ba0c30ba3d0810fc79e12a50a",
"chatroom": {
"name": "main",
"users": [
{"Username": "alice", "Token": ""},
{"Username": "bob", "Token": ""}
],
"messages": [
{"Token": "", "Type": "message", "Author": "alice", "Content": "Hi!", "Chatroom": "main"},
{"Token": "", "Type": "message", "Author": "bob", "Content": "Hello!", "Chatroom": "main"}
]
}
}⚠️ 注意事项
- Go 的 JSON 序列化不关心字段标签值是否正确，只关心字段是否可导出；
- json:"-" 可安全用于排除字段，但前提是该字段本身是导出的（否则本就不会被序列化）；
- 自定义类型（如 type Messages []Message）若需 JSON 支持，建议要么导出类型名，要么直接使用原生切片以降低复杂度；
- 始终对结构体使用 type MyStruct struct { ... } 显式声明（而非匿名结构体），便于调试和反射。
通过统一导出所有需序列化的字段，并规避未导出类型别名，即可彻底解决嵌套结构 JSON 输出为空的问题。
