使用 golang.org/x/net/websocket 接收客户端发送的 JSON 字符串时，若结构体字段未导出或缺少 JSON 标签，websocket.JSON.Receive 将无法反序列化数据，导致字段为空；需确保结构体字段首字母大写并添加 json:"key" 标签。
使用 `golang.org/x/net/websocket` 接收客户端发送的 json 字符串时，若结构体字段未导出或缺少 json 标签，`websocket.json.receive` 将无法反序列化数据，导致字段为空；需确保结构体字段首字母大写并添加 `json:"key"` 标签。
在 Go 中通过 websocket.JSON.Receive 解析前端发送的 JSON 数据（如 socket.send('{"text":"111"}')），关键在于 Go 结构体与 JSON 的映射规则。你原始代码中定义的结构体：
type Item struct {
text string // ❌ 首字母小写 → 非导出字段 → JSON 包无法访问
}
由于 Go 的 JSON 反序列化器（包括 websocket.JSON.Receive 内部使用的 json.Unmarshal）仅能设置导出（首字母大写）字段，text 是私有字段，因此即使 JSON 正确，data.text 始终为空。
✅ 正确做法是：定义导出字段，并显式指定 JSON 键名：
type SocketData struct {
Text string `json:"text"` // ✅ 导出字段 + json tag
}
然后在 ChatServer 中使用：
for {
var data SocketData
err := websocket.JSON.Receive(ws, &data)
if err != nil {
log.Printf("JSON receive error from %s: %v", clientKey, err)
return
}
messages <p>⚠️ 注意事项：</p>
- websocket.JSON.Receive(ws, &v) 要求 v 是指针，且其底层类型必须支持 JSON 反序列化（如导出结构体、map[string]interface{} 或基础类型）；
- 若需灵活处理未知结构（如动态字段），可使用 map[string]interface{}：
var payload map[string]interface{}
if err := websocket.JSON.Receive(ws, &payload); err != nil {
log.Println("Failed to parse JSON:", err)
continue
}
if text, ok := payload["text"].(string); ok {
messages
- 不推荐长期依赖 interface{}，因缺乏类型安全和 IDE 支持；建议为每类消息定义明确结构体（如 TextMessage、PingMessage），配合 switch 或自定义 UnmarshalJSON 实现多态解析；
- golang.org/x/net/websocket 已归档废弃（自 Go 1.19+ 起不再维护），生产环境强烈推荐迁移到更现代、标准且活跃的库，如 gorilla/websocket 或 nhooyr.io/websocket，它们提供更好的错误处理、并发安全及上下文支持。
总结：JSON 反序列化的前提是「导出 + 标签」，这是 Go 类型系统与反射机制的基本约束；修复结构体可见性后，你的 WebSocket 消息即可稳定双向通信。
