计算机网络 / 系统课时
消息为什么不能只传一段字符串
消息为什么不能只传一段字符串
把 WebSocket 消息当成普通字符串,在只有一个功能时很省事,但一旦出现多种事件、请求响应、重试和兼容需求,就会很快失去边界。本节用一个最小消息信封把路由、关联和错误处理固定下来。
学习目标
- 理解纯字符串消息在路由、请求关联和错误处理上的局限。
- 能设计包含
type、requestId和data的统一消息结构。 - 能用稳定的消息类型和兼容策略演进协议,而不破坏旧客户端。
纯字符串为什么会失控
如果客户端只发送 hello、join room-1 或一段任意 JSON 字符串,服务端就必须依赖内容格式去猜“这是什么消息”。功能一多,解析代码会同时承担路由、参数读取、异常判断和响应关联,任何格式变化都可能影响其他分支。
真正需要固定的是消息外层边界,而不是把所有业务字段塞进一个大对象。一个实用的最小信封可以只保留三个核心字段:
| 字段 | 作用 | 设计要求 |
|---|---|---|
type |
决定消息交给哪个处理器 | 使用稳定、可枚举的事件名 |
requestId |
把响应或错误关联回原请求 | 同一请求链路保持不变 |
data |
承载当前事件自己的业务数据 | 由具体 type 定义结构 |
这样,连接层只负责解析信封并路由,业务处理器只关心自己的 data。
用 type 路由,用 requestId 关联
下面的 Node.js 示例演示一个最小路由器。它接收一条 JSON 字符串,根据 type 选择处理函数,并在成功或失败响应中原样带回 requestId,因此客户端可以同时发出多条请求而不混淆结果。
const handlers = {
'chat.send': data => {
if (!data.roomId || !data.text) {
return {
type: 'chat.send.error',
data: { code: 'INVALID_ARGUMENT', message: 'roomId and text are required' }
};
}
return {
type: 'chat.send.ok',
data: { messageId: 'msg-demo-1' }
};
}
};
function handleMessage(raw) {
const message = JSON.parse(raw);
if (typeof message.type !== 'string' || typeof message.requestId !== 'string') {
throw new Error('invalid message envelope');
}
const handler = handlers[message.type];
if (!handler) {
return JSON.stringify({
type: 'system.error',
requestId: message.requestId,
data: { code: 'UNSUPPORTED_TYPE' }
});
}
const result = handler(message.data ?? {});
return JSON.stringify({
type: result.type,
requestId: message.requestId,
data: result.data
});
}
const request = JSON.stringify({
type: 'chat.send',
requestId: 'req-demo-1',
data: { roomId: 'room-demo', text: 'hello' }
});
console.log(handleMessage(request));预期输出
{"type":"chat.send.ok","requestId":"req-demo-1","data":{"messageId":"msg-demo-1"}}这里 type 解决“交给谁处理”,requestId 解决“这是哪次请求的结果”,data 解决“当前事件需要哪些业务字段”。三者职责分开后,连接层不需要理解聊天、订单或通知等具体业务。
错误也要走同一套消息模型
错误不要退回到随意字符串,例如 room not found。更稳定的做法是仍然返回结构化消息,并保持原 requestId。客户端可以先按 type 判断这是成功还是失败,再读取 data.code 做程序化处理,而 data.message 只用于展示或调试。
例如请求类型是 chat.send,可以约定成功返回 chat.send.ok,参数错误返回 chat.send.error,未知事件返回 system.error。这样即使并发发送十条请求,也能按 requestId 将每个结果准确交给原调用方。
版本兼容从 data 开始控制
协议演进时,优先做向后兼容的增加:给 data 新增可选字段,而不是改变旧字段含义。例如旧客户端只认识 roomId 和 text,新服务端可以增加可选的 mentions,只要缺失时仍按旧逻辑处理,旧客户端就不会被破坏。
如果必须做破坏性变更,应显式区分新旧协议,例如把消息类型升级为 chat.send.v2,或在信封中额外引入独立版本字段。不要让同一个 type 在不同时间代表两种不兼容的数据结构,否则服务端和客户端都无法仅凭消息本身判断应该按哪套规则解析。
当一条消息能独立回答“它是什么、属于哪次请求、业务数据在哪里”这三个问题时,WebSocket 才从“传字符串的长连接”变成可维护的应用协议。