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

解决WebSocket连接后无法发送数据问题 状态检查与异常处理教程

酷敏小哥_9764

酷敏小哥_9764

发布时间:2026-06-02 18:52:36

|

955人浏览过

|

来源于php中文网

原创

WebSocket发送数据前必须检查readyState为OPEN,封装safeSend函数;捕获onerror和onclose并依据event.code判断重连;确保数据类型匹配服务端要求;手动实现心跳保活;readyState是瞬时状态,需多层兜底。

websocket连接后无法发送数据,90%不是网络或服务端问题,而是客户端没做状态校验或错误未捕获。

检查 socket.readyState 是否为 1(OPEN)再发数据

很多开发者在 onopen 回调里直接发一次数据,之后就不管状态了——但网络抖动、代理中断、服务端主动断连都会让 readyState 变成 0(CONNECTING)、2(CLOSING)或 3(CLOSED),此时调用 send() 不报错,但数据根本不会发出。

  • 永远不要在未检查状态时调用 socket.send();必须写成 if (socket.readyState === WebSocket.OPEN) { socket.send(...) }
  • 封装一个安全发送函数,避免重复判断:
    function safeSend(socket, data) {
      if (socket.readyState === WebSocket.OPEN) {
        socket.send(data);
      } else {
        console.warn('skip send: socket not open', socket.readyState);
      }
    }
  • 注意:WebSocket.OPEN 是常量值 1,但建议用常量而非硬编码数字,提高可读性

捕获 onerror 和 onclose 并区分异常类型

onerror 是连接阶段失败的兜底入口,但不包含具体原因;真正能拿到错误码的是 onclose 的 event.code。两者必须配合使用,否则重连逻辑会盲目触发。

  • onerror 触发时,event 对象通常为空或只有 type 字段,不能依赖它判断是否该重连
  • onclose 的 event.code 才是关键:1000(正常关闭)不重连,1006(异常断连)、1011(服务端内部错误)才应触发重连
  • 不要在 onerror 里直接调用 socket.close() —— 若连接还没建立成功,socket 可能处于 CONNECTING 状态,此时 close() 会抛 InvalidStateError

发送前确认数据类型与服务端预期一致

WebSocket 协议本身不定义消息语义,send() 接收 string、ArrayBuffer、Blob 或 ArrayBufferView,但服务端解析逻辑往往只支持其中一种。类型错配会导致静默丢弃或连接被强制关闭。

WebSocket 8.18.2
WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。

下载
  • 发送 JSON 必须先 JSON.stringify(),不能直接 send({ type: 'msg' })
  • 若服务端要求二进制帧(如 Protobuf),客户端必须构造 ArrayBuffer 并传入 send(),不能传字符串
  • 发送非 UTF-8 字符串(如 GBK 编码文本)会触发协议级错误,导致连接关闭,浏览器控制台显示 Failed to execute 'send' on 'WebSocket': InvalidAccessError

心跳保活缺失导致“看似连接成功,实则发不出数据”

很多中间设备(Nginx、ALB、CDN)默认 60 秒无流量就回收 TCP 连接。WebSocket 虽有 Ping/Pong 帧机制,但浏览器原生 API 不自动发送,必须手动实现。

  • 服务端未开启心跳时,客户端需每 45 秒左右发一次 socket.send('ping')(内容按约定,如纯字符串 'ping')
  • 收到服务端回的 'pong' 后重置本地心跳计时器;超时未收到则主动 close() 并触发重连
  • 避免用 setInterval 无条件发 ping:如果连接已断开,send() 会静默失败,且可能堆积定时器

最易被忽略的一点:readyState 是瞬时快照,不是锁。即使刚检查完是 OPEN,调用 send() 的瞬间也可能因网络抖动变为 CLOSED。所以生产环境必须结合 onerror + onclose + 发送失败回调(如有)三层兜底,不能只信一次状态检查。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

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

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

LibLibAI
LibLibAI Hot

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2669

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2128

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1100

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1038

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1276

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

1958

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2980

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

12975

2023.09.22

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

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

精品课程

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

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习

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

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