Go 使用 golang.org/x/net/websocket 接收 JSON 消息时，若结构体字段未导出或缺少 JSON 标签，websocket.JSON.Receive 将无法反序列化数据，导致字段为空；正确做法是定义含导出字段和 json:"..." 标签的结构体，或使用 map[string]interface{} 动态解析。
go 使用 `golang.org/x/net/websocket` 接收 json 消息时，若结构体字段未导出或缺少 json 标签，`websocket.json.receive` 将无法反序列化数据，导致字段为空；正确做法是定义含导出字段和 `json:"..."` 标签的结构体，或使用 `map[string]interface{}` 动态解析。
在 Go WebSocket 服务端开发中，websocket.JSON.Receive 是一个便捷的工具函数，用于直接将客户端发送的 JSON 字符串反序列化为 Go 结构体。但其行为高度依赖结构体的可导出性（首字母大写） 和 JSON 标签声明。你原始代码中定义的 Item 结构体：
type Item struct {
text string // ❌ 非导出字段（小写开头），JSON 解析器无法访问
}由于 text 是小写私有字段，encoding/json（websocket.JSON 底层依赖它）在反序列化时会忽略该字段，因此 data.text 始终为空字符串，即使客户端发送了 {"text":"111"}。
✅ 正确做法是：将字段名改为大写，并显式添加 JSON 标签：
type Item struct {
Text string `json:"text"` // ✅ 导出字段 + 明确映射
}完整修复后的 ChatServer 关键部分如下：
func ChatServer(ws *websocket.Conn) {
msgChan := make(chan *Msg, 100)
clientKey := time.Now().String()
clientRequests <- &NewClientEvent{clientKey, msgChan}
defer func() { clientDisconnects <- clientKey }()
go func() {
for msg := range msgChan {
if err := websocket.JSON.Send(ws, map[string]string{"text": msg.text}); err != nil {
log.Printf("Send error: %v", err)
return
}
}
}()
for {
var data Item
err := websocket.JSON.Receive(ws, &data)
if err != nil {
log.Printf("JSON receive error: %v", err)
return
}
messages <- &Msg{clientKey, data.Text} // 注意：使用 Text（大写）
}
}⚠️ 同时注意：你原结构体 Msg 和 NewClientEvent 中的 clientKey、msgChan 等字段也应保持导出（如 ClientKey, MsgChan），否则在跨包或反射场景下可能引发隐性问题（尽管当前逻辑未暴露）。
? 替代方案：动态解析未知结构 若需支持多种不固定格式的 JSON（如混合命令、事件类型），推荐使用 map[string]interface{}：
var payload map[string]interface{}
if err := websocket.JSON.Receive(ws, &payload); err != nil {
log.Printf("Parse dynamic JSON failed: %v", err)
return
}
if text, ok := payload["text"].(string); ok {
messages <- &Msg{clientKey, text}
} else {
log.Println("Missing or invalid 'text' field")
}? 最佳实践总结：
- 所有需 JSON 反序列化的结构体字段必须首字母大写（导出）；
- 强烈建议显式声明 json:"field_name" 标签，避免大小写歧义；
- 避免使用 string 类型接收对象 JSON（如 socket.send('"text"')），这属于 JSON 字符串字面量，而非对象，语义错误且不可扩展；
- golang.org/x/net/websocket 已被官方标记为deprecated，生产环境建议迁移至更现代、活跃维护的库，如 gorilla/websocket 或 nhooyr.io/websocket，它们提供更健壮的错误处理、上下文支持及性能优化。
通过规范结构体定义与合理选择解析策略，即可稳定、高效地处理 WebSocket 上的 JSON 通信。
