必须手动序列化和反序列化，websocket协议本身不解析json；直接传对象会发送"[object object]"，服务端无法获取结构化数据；需用json.stringify()发送并加try-catch防undefined、循环引用等导致静默失败，后端须显式json.unmarshal或配置decoder.text解析。
必须手动序列化和反序列化，WebSocket协议本身不认JSON。直接传对象会发过去"[object Object]"，服务端收不到结构化数据；不加错误捕获，undefined、循环引用、Date实例等会让send()静默失败。
前端发送：JSON.stringify() 是唯一安全路径
原生WebSocket.send()只接受string、ArrayBuffer、Blob或TypedArray。JS对象不是合法类型，也不会自动转换。
- ✅ 正确写法：
socket.send(JSON.stringify({ type: "ping", ts: Date.now() })) - ❌ 错误写法：
socket.send({ type: "ping" })→ 服务端收到"[object Object]" - ⚠️ 高危字段：
new Date()、function、undefined、Infinity会触发TypeError，必须提前过滤或替换 - ? 建议包裹
try...catch，避免因序列化失败导致消息丢失无提示
后端接收：不能依赖“自动解析”，得自己json.Unmarshal或配Decoder.Text
无论用 Go（gorilla/websocket）、Java（javax.websocket）还是 Python（FastAPI），默认都不拆包JSON——你收到的永远是原始字符串。
- Go 示例：
err := json.Unmarshal(message, &req); if err != nil { /* 处理解析失败 */ } - Spring Boot：
@OnMessage参数若为String，需手动new ObjectMapper().readValue(data, Xxx.class)；若想直接收User对象，必须在@ServerEndpoint(decoders = {UserDecoder.class})里声明解码器，且willDecode()返回true - FastAPI：
await websocket.receive_json()是封装好的快捷方式，底层仍是json.loads()，但会自动抛出WebSocketDisconnect或JSONDecodeError
跨语言兼容性：别信“智能识别”，统一约定格式再校验
没有标准规定 WebSocket 消息体必须是 JSON，也没有中间件会主动 sniff 内容类型。前后端必须事先约定字段名、必选/可选、空值处理逻辑。
- 字段缺失时，前端
msg.user?.name比msg.user.name更健壮 - 后端建议对关键字段做存在性检查，比如
if req.Type == "" { return errors.New("missing 'type'") } - 时间戳统一用
number（毫秒级Date.now()），不用string格式日期，避免解析歧义 - 不要在 JSON 里传二进制数据（如图片 base64），体积大、易出错；改用
ArrayBuffer单独发
最容易被忽略的是错误边界：前端没try-catch，后端没json.Unmarshal错误处理，一遇到非法值就静默断连或丢包。真实线上环境里，这类问题往往拖到用户反馈才暴露。
