计算机网络 / 系统课时

消息为什么不能只传一段字符串

消息为什么不能只传一段字符串

把 WebSocket 消息当成普通字符串,在只有一个功能时很省事,但一旦出现多种事件、请求响应、重试和兼容需求,就会很快失去边界。本节用一个最小消息信封把路由、关联和错误处理固定下来。

学习目标

  • 理解纯字符串消息在路由、请求关联和错误处理上的局限。
  • 能设计包含 type、requestId 和 data 的统一消息结构。
  • 能用稳定的消息类型和兼容策略演进协议,而不破坏旧客户端。

纯字符串为什么会失控

如果客户端只发送 hello、join room-1 或一段任意 JSON 字符串,服务端就必须依赖内容格式去猜“这是什么消息”。功能一多,解析代码会同时承担路由、参数读取、异常判断和响应关联,任何格式变化都可能影响其他分支。

真正需要固定的是消息外层边界,而不是把所有业务字段塞进一个大对象。一个实用的最小信封可以只保留三个核心字段:

字段 作用 设计要求
type 决定消息交给哪个处理器 使用稳定、可枚举的事件名
requestId 把响应或错误关联回原请求 同一请求链路保持不变
data 承载当前事件自己的业务数据 由具体 type 定义结构

这样,连接层只负责解析信封并路由,业务处理器只关心自己的 data。

用 type 路由,用 requestId 关联

下面的 Node.js 示例演示一个最小路由器。它接收一条 JSON 字符串,根据 type 选择处理函数,并在成功或失败响应中原样带回 requestId,因此客户端可以同时发出多条请求而不混淆结果。

js
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));

预期输出

text
{"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 才从“传字符串的长连接”变成可维护的应用协议。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

消息为什么不能只传一段字符串

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通