WebSocket发送Json对象怎么写 WebSocket数据序列化方法【教程】

陆砚码

2026-09-28 • 👁 1人浏览过

必须先调用 JSON.stringify() 将对象转为字符串，否则 send() 会发送 "[object Object]" 或报错；WebSocket 协议本身不解析 JSON，收发均需手动序列化与反序列化。必须先

JSON.stringify()

，否则会报错或发空消息。 WebSocket 的

send()

方法只接受

string

或

ArrayBuffer

Blob

TypedArray

，直接传入 JS 对象（如

{type: "login", user: "Alice"}

）不会报语法错误，但服务端收到的是

[object Object]

或空字符串——这是最常踩的坑。前端发送 JSON：必须 stringify，且建议加 try-catch 客户端用原生 WebSocket 发送结构化数据时，核心就一条：对象 → 字符串。不封装、不省略、不依赖“自动转换”。

socket.send()

不会自动序列化对象，传入对象等于传入

String(obj)

，结果是

"[object Object]"

必须显式调用

JSON.stringify(message)

，且建议包裹在

try...catch

中，避免因循环引用、

undefined

、

Date

等非法值导致

send()

失败静默丢包示例中

timestamp: Date.now()

是安全的，但

new Date()

或

function

字段会抛

TypeError

const socket = new WebSocket('ws://localhost:8080');
socket.onopen = () => {
  const msg = { type: 'auth', token: 'abc123', expires_at: Date.now() + 3600000 };
  try {
    socket.send(JSON.stringify(msg)); // ✅ 正确
  } catch (e) {
    console.error('JSON serialization failed:', e);
  }
};

Java 后端接收 JSON：Decoder.Text 是绕不开的配置项 Spring WebSocket 或原生

javax.websocket

默认不解析 JSON。若想让

@OnMessage

方法直接接收 Java 对象（如

User

），必须注册自定义

Decoder.Text

，否则只能拿到原始字符串再手动解析。没配

decoders

时，

@OnMessage

参数只能是

String

、

byte[]

或

ByteBuffer

配了

decoders

后，WebSocket 容器会在调用

@OnMessage

前自动调用你实现的

decode()

方法，把字符串转成目标对象常见错误：忘记在

@ServerEndpoint

注解里声明

decoders = {UserDecoder.class}

，或

willDecode()

false

导致跳过解码关键代码片段（非完整类）： php版微信js-sdk支付接口类 php版微信js-sdk支付接口类下载

@ServerEndpoint(value = "/ws", decoders = {UserDecoder.class})
public class ChatEndpoint {
  @OnMessage
  public void onMessage(User user, Session session) { // ✅ 这里能直接收 User 对象
    System.out.println(user.getName());
  }
}

跨语言/跨库兼容性：别依赖“自动 JSON 检测” 不同语言的 WebSocket 库对 JSON 的处理策略差异很大——Python 的

websockets

、C 的

libwebsockets

、.NET 的

WebSocket4Net

全都不识别内容类型，也不会尝试解析 JSON。所谓“发送 JSON”，本质只是发送一串符合 JSON 语法规则的文本。服务端不能假设客户端发的是 JSON；客户端也不能假设服务端返回的是可直接

JSON.parse()

的字符串（比如可能混着二进制帧或带前缀协议头）如果用

fastjson

或

ObjectMapper

解析，注意反序列化时字段名大小写、null 值处理、时间格式等细节，和前端

JSON.stringify()

的输出要对齐 C 语言示例里用

cJSON_AddStringToObject()

构建对象再

cJSON_Print()

转字符串，就是最朴素也最可靠的路径真正容易被忽略的点是：WebSocket 协议层根本不关心你传的是 JSON、XML 还是纯文本。所有“JSON 支持”都是应用层自己加的序列化/反序列化逻辑。一旦前后端约定不一致（比如前端漏了

stringify

，后端却硬解），问题往往表现为“收不到”或“字段为空”，而不是明显报错。

相关文章