Firefox连接/断开WiFi时本地WebSocket readyState异常问题咨询

问题现象 #

• 基于Tcl搭建本地服务器，通过程序化启动浏览器（Firefox/Brave）作为UI，WebSocket通信原本正常
• 切换外部网络（断开/连接）后，Firefox发送WebSocket请求时连接被中断，报错信息：

  The connection to ws://127.0.0.15:34405/reqWS/1/basic/main was interrupted while the page was loading.
  

• 发送请求前检查WebSocket的readyState=1（连接正常），发送后立即触发onerror和onclose事件，状态变为3（关闭）；同页面的HTTP请求可正常收发
• Chrome系浏览器（如Brave）无此异常
• 使用固定端口（如8000、8080）时无问题，改为Tcl随机分配端口后出现该现象；Firefox发送PING请求、服务器返回PONG时无报错，但后续业务请求触发连接断开

可能原因 #

1. Firefox -offline参数与随机端口的策略冲突：启动Firefox时添加了-offline参数，强制浏览器进入离线模式。当外部网络状态变更时，Firefox的离线状态感知逻辑会错误地将随机端口的WebSocket连接判定为“需要外网验证”，触发隐性的连接中断。
2. Firefox网络状态变更的会话重置逻辑：网络切换时，Firefox会重置部分网络会话，但随机端口的本地连接未被纳入白名单，导致后续请求被判定为异常连接并强制关闭。
3. Tcl随机端口Socket的参数配置缺失：随机端口分配后，服务器Socket未配置TCP保活等参数，与Firefox的WebSocket超时校验逻辑不匹配，网络状态变更后被误判为无效连接。

解决办法 #

1. 移除Firefox启动的-offline参数 #

你的场景是纯本地通信，-offline参数完全多余，反而会干扰Firefox对本地连接的判断。修改后的启动命令：

# Firefox
exec firefox -P "ToolTest" -no-remote -new-instance \
    -private -url http://${addr}:${port}/login &

2. 为WebSocket握手添加禁用缓存的响应头 #

在Tcl服务器处理WebSocket握手请求时，添加以下响应头，避免Firefox对随机端口连接进行缓存或网络关联校验：

# 示例：WebSocket握手响应时添加头
puts $client "HTTP/1.1 101 Switching Protocols"
puts $client "Upgrade: websocket"
puts $client "Connection: Upgrade"
puts $client "Sec-WebSocket-Accept: $acceptKey"
puts $client "Cache-Control: no-cache"
puts $client "Pragma: no-cache"
puts $client ""
flush $client

3. 配置Tcl服务器Socket的TCP保活参数 #

确保本地Socket的保活机制正常，避免网络切换后Firefox误判连接失效：

# 假设$serverSocket是你的Tcl服务器监听Socket
socket configure $serverSocket -keepalive 1 -idle 30 -interval 10 -count 3

4. 浏览器端添加WebSocket重连逻辑 #

针对Firefox的异常断开，在前端代码中添加自动重连逻辑（本地连接重连成本极低）：

function setupWebSocket(port) {
    const wsUrl = `ws://127.0.0.15:${port}/reqWS/1/basic/main`;
    const ws = new WebSocket(wsUrl);

    ws.onclose = (event) => {
        // 1006为异常断开的状态码
        if (event.code === 1006) {
            setTimeout(() => setupWebSocket(port), 1000);
        }
    };

    // 处理message、error等其他事件
    ws.onmessage = (event) => {
        // 业务逻辑处理
    };
}

验证步骤 #

1. 移除-offline参数后，切换外部网络，测试WebSocket请求是否正常
2. 检查服务器WebSocket握手响应头是否包含Cache-Control: no-cache和Pragma: no-cache
3. 测试随机端口下，网络切换后的PING/PONG交互及后续业务请求是否稳定

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