基于node.js的协作绘图应用WebSocket reserved位报错无法操作求助

错误根因说明 #

你遇到的WebSocket connection to failed: One or more reserved bits are on: reserved1 = 0, reserved2 = 1, reserved3 = 1报错，是WebSocket帧解析阶段的协议级错误，违反了RFC6455规范中帧头保留位必须全部置0的要求，几乎都是数据传输过程中帧结构被篡改导致的。

排查步骤 #

• 优先检查O2switch虚拟主机的反向代理配置：Cpanel默认的Apache/Nginx规则如果没有专门适配WebSocket，会把WebSocket的ws/wss流量当作普通HTTP请求处理，修改帧头触发保留位异常。需要在Cpanel的虚拟主机配置中添加对Upgrade和Connection请求头的透传规则，开启WebSocket代理支持。
• 临时关闭Cpanel的ModSecurity WAF测试：部分WAF规则会扫描WebSocket传输的内容，扫描过程中如果修改了帧的二进制结构就会触发该报错，关闭后如果故障消失，就需要调整WAF规则放行WebSocket流量。
• 关闭WebSocket压缩扩展测试：如果你的服务端开启了permessage-deflate等帧压缩扩展，部分虚拟主机的传输层不支持这类扩展协商，会导致帧结构解析错误，可以在服务端ws库配置中关闭压缩功能后测试。
• 优化前端高频消息发送逻辑：绘制线条时会高频发送绘图数据，没有限流的情况下可能出现消息堆积、帧边界错乱的情况，建议添加消息队列，控制每秒发送的消息数量不超过30条。

验证方法 #

先在本地环境启动项目测试，如果本地操作完全没有报错，就可以确定是部署平台的配置问题，直接联系O2switch的技术支持确认你的主机套餐是否支持长连接WebSocket服务即可。

内容的提问来源于stack exchange，提问作者florianne