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

夏芳姑娘_6477

夏芳姑娘_6477

2026-08-02

660人浏览

原创

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。例如:

// 发送端(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);
}

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

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
// 接收端(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 

<h3>备选方案:分隔符(适合纯文本,慎用于二进制)</h3>
<p>若只传 UTF-8 文本且不含换行符,可用 <code>\n</code> 分隔:</p>
  • 发送:ws.send(JSON.stringify(msg) + '\n')
  • 接收:将所有数据按 \n 切分,但注意最后可能残留半包(末尾无 \n),需缓存未结束行

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

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

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

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

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.06.20

4406

5

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

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

2023.07.04

1109

3

js四舍五入
js四舍五入

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

2023.07.04

4324

6

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

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

2023.09.01

880

4

JavaScript转义字符
JavaScript转义字符

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

2023.09.04

1776

5

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

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

2023.09.04

3185

4

如何启用JavaScript
如何启用JavaScript

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

2023.09.12

4133

6

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

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

2023.09.20

2660

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

868

7

热门下载

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

精品课程

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

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习