PeerJS与Socket.IO同端口部署WebSocket无效帧头错误排查
报错根因
这个错误本质是同端口下两个WebSocket服务的全局监听抢占导致的:
- 初始化Socket.IO时,已经给原生HTTP服务器对象
server注册了全局的WebSocket请求升级监听,会处理所有路径下的WebSocket连接请求 - 你初始化ExpressPeerServer时直接传入了
server对象,会让PeerServer也在底层注册一份全局的WebSocket升级监听,完全无视你通过app.use('/peerjs', ...)配置的路径前缀规则 - 当浏览器发起Socket.IO的WebSocket连接时,两个全局监听器会无序竞争请求处理权:如果PeerServer的监听抢先拿到了原本属于Socket.IO的二进制帧,就会用自己的帧格式规则去解析,最终输出
Invalid frame header的解析错误 - 这种冲突和代码里的路径写得对不对没关系,只要两个服务同时给同一个
server挂全局WebSocket监听,就会随机触发帧解析失败的问题
可直接落地的修复方案
按以下步骤修改server.js即可:
- 修改ExpressPeerServer的初始化入参,不要传入全局
server对象,改为传入Express实例app - 给PeerServer显式配置和路由一致的
path参数,让它自己完成路径级别的请求分发 - 保持现有代码里Socket.IO先初始化、PeerServer后挂载的顺序,不要调换两者的初始化顺序
替换原来的PeerServer代码块:
// 原来的错误写法 // const peerServer = ExpressPeerServer(server, { // debug: true, // }); // app.use('/peerjs', peerServer); // 替换为以下正确写法 const peerServer = ExpressPeerServer(app, { debug: true, path: '/peerjs', // 路径和app.use的挂载路径保持一致 }); app.use('/peerjs', peerServer);
改完后重启服务,两个服务会按路径规则分别处理请求:
- 路径为
/peerjs的WebSocket请求会被PeerServer正常处理 - 路径为
/socket.io的WebSocket请求会被Socket.IO正常处理,不会再出现帧解析错误
内容的提问来源于stack exchange,提问作者user13585926
相关产品推荐
相关产品推荐

