WebSocket 常见的错误

一、连接相关错误

（一）连接超时

• 原因：在规定的时间内无法成功建立与服务器的 WebSocket 连接。
• 示例：如果网络状况不佳，或者服务器响应缓慢，导致在客户端设置的连接超时时间内未能完成连接建立的握手过程，就会出现此错误。

（二）连接被拒绝

• 原因：服务器拒绝了客户端发起的 WebSocket 连接请求。
• 示例：可能是服务器端的配置问题，例如服务器达到了连接上限，或者服务器的安全策略阻止了来自特定客户端的连接请求；也可能是客户端提供的认证信息不正确，导致服务器拒绝连接。

二、数据传输相关错误

（一）消息格式错误

• 原因：发送或接收的数据格式不符合 WebSocket 协议的规范。
• 示例：如果发送的数据不是有效的字符串、二进制数据，或者数据的编码格式不正确，接收端在解析时就会出现格式错误。

（二）数据过大

• 原因：发送的数据大小超过了 WebSocket 协议或服务器设置的限制。
• 示例：当尝试发送一个非常大的文件或大量数据，而服务器无法处理这么大的数据量时，会引发此错误。

三、连接关闭相关错误

（一）意外关闭

• 原因：连接在没有预期的情况下被关闭，可能是网络中断、服务器故障或其他异常情况。
• 示例：网络突然断开，或者服务器由于内存泄漏、进程崩溃等原因突然停止运行，导致正在进行的 WebSocket 连接被中断。

（二）协议错误

• 原因：在通信过程中违反了 WebSocket 协议的规定。
• 示例：比如在不适当的时候发送控制帧，或者对控制帧的处理不符合协议要求。