讲师中心 微信公众号
AI工具推荐 视频效率加速

JavaScript 中 WebSocket 怎么处理黏包与分包解析逻辑

夏芳姑娘_6477

夏芳姑娘_6477

发布时间:2026-08-02 16:58:59

|

660人浏览过

|

来源于php中文网

原创

WebSocket帧层自动处理TCP黏包,但业务消息需应用层解决帧内黏包;推荐长度前缀+二进制帧方案,发送时加4字节大端长度头,接收端依头解析。

javascript 中 websocket 怎么处理黏包与分包解析逻辑

WebSocket 协议本身不解决黏包与分包问题,但它的帧层(frame layer)已由浏览器和服务器底层(如 Netty、Node.js 的 ws 库)自动处理 TCP 层的粘包/拆包。真正需要你关注和编码的,是 WebSocket 帧 payload 内部的业务消息如何切分——也就是“帧内黏包”。

浏览器端 WebSocket 默认不暴露帧边界,需自行协议设计

浏览器原生 WebSocket API 只提供 message 事件,且:

  • 文本帧(TextWebSocketFrame)会自动转成 string 或 DOMString,但若后端拼了多个 JSON,前端收到的就是一串无分隔的字符串(如 '{"id":1}{"id":2}'),无法直接 JSON.parse
  • 二进制帧(BinaryWebSocketFrame)传入的是 ArrayBuffer 或 Blob,内容完全由你定义,没有内置长度或分隔符

这意味着:你不能依赖 event.data 天然对应一条业务消息;必须在应用层约定解析规则。

推荐方案:长度前缀 + 二进制帧(最健壮)

在发送前对每条业务消息加 4 字节大端序长度头(Uint32BE),再拼接 body。例如:

立即学习“Java免费学习笔记(深入)”;

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载
// 发送端(JS)
function sendPacket(data) {
  const encoder = new TextEncoder();
  const body = encoder.encode(JSON.stringify(data));
  const header = new ArrayBuffer(4);
  const view = new DataView(header);
  view.setUint32(0, body.length, false); // false = big-endian

  const packet = new Uint8Array(header.byteLength + body.length);
  packet.set(new Uint8Array(header), 0);
  packet.set(body, 4);

  ws.send(packet.buffer);
}

接收端维护一个缓冲区,按长度头逐步切包:

// 接收端(JS)
let buffer = new Uint8Array(0);

ws.onmessage = (e) => {
  const chunk = new Uint8Array(e.data);
  buffer = concatUint8Array(buffer, chunk);

  while (buffer.length >= 4) {
    const view = new DataView(buffer.buffer, buffer.byteOffset);
    const len = view.getUint32(0, false); // 读长度头

    if (buffer.length < 4 + len) break; // 包不完整,等下一次

    const body = buffer.slice(4, 4 + len);
    try {
      const msg = JSON.parse(new TextDecoder().decode(body));
      handleMessage(msg);
    } catch (err) {
      console.warn('解析失败', body);
    }

    buffer = buffer.slice(4 + len); // 截掉已处理部分
  }
};

备选方案:分隔符(适合纯文本,慎用于二进制)

若只传 UTF-8 文本且不含换行符,可用 \n 分隔:

  • 发送:ws.send(JSON.stringify(msg) + '\n')
  • 接收:将所有数据按 \n 切分,但注意最后可能残留半包(末尾无 \n),需缓存未结束行

⚠️ 不适用于二进制数据(\n 可能出现在原始字节中),也不适合 Protobuf/MessagePack 等序列化格式。

服务端必须配合,否则前端白忙

前端加长度头,后端也得用对应解码器(如 Netty 的 LengthFieldBasedFrameDecoder)提前拆好帧内消息,再投递给业务 handler。如果后端直接把整帧当一条消息转发,前端再怎么解析也没用。

关键点:前后端必须约定一致的子协议,包括字节序、长度字段位置、是否含命令字、body 编码方式等。调试时可先用 console.log(new Uint8Array(e.data)) 打印原始字节,确认结构是否符合预期。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

4386

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

1109

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

4304

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

880

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

1776

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

3165

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

4133

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2660

2023.09.20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebSocket手册
WebSocket手册

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn