You need to enable JavaScript to run this app. Python websockets客户端无法检测服务器主动关闭连接问题求解
优惠活动
大模型
产品
解决方案
定价
更多

Python websockets客户端无法检测服务器主动关闭连接问题求解

问题根源

你遇到的现象本质是没有安排协程消费WebSocket连接上的入站数据帧,属于websockets异步库的典型入门使用误区,和心跳配置、服务端的关闭逻辑本身没有关系。

为什么无法感知服务端的关闭动作

websockets库的连接状态更新,完全依赖入站帧的驱动触发:

  • 服务端传过来的所有数据,不管是业务消息、Ping/Pong控制帧,还是标识连接关闭的Close帧,都会被存到连接对象内部的入站队列中。
  • 只有当你主动调用recv()方法、或者有常驻协程循环读取入站队列时,库才会解析这些帧,更新连接的内部状态,抛出对应的连接关闭异常。
  • 你当前的逻辑只通过run_until_complete跑完了连接建立的流程,就直接暂停了事件循环的调度,根本没有任何协程在持续读取入站数据。哪怕服务端发的Close帧已经到达客户端的操作系统TCP缓冲区,应用层也没有主动把数据读出来解析,自然没办法感知到连接已经被服务端关闭。

为什么能向已关闭的连接发消息

你感知到的“可以正常发消息”只是表面假象:

  • send()操作本质只是把要发送的业务消息序列化后,扔到TCP的发送内存缓冲区。只要操作系统层面还没检测到对端连接异常(比如没收到TCP RST包),这个写操作就不会报错。
  • 因为没有入站消费逻辑,websockets库本身也不会主动去解析流里的Close帧,也就不会把连接标记为已关闭,你直接调用send方法的时候自然拿不到连接状态异常的报错。
    这点和Chrome扩展、同步版websocket-client库的逻辑有本质区别:这两个客户端内部都独立跑了阻塞读TCP流的线程,只要读到Close帧就立刻把连接标记为关闭,所以能快速感知断开。

正确的修复方案

  • 建立连接后,必须启动一个常驻协程,持续消费连接的入站数据,同时处理连接关闭的异常状态:
    async def _connection_event_loop(self):
        try:
            # 循环读取所有入站消息,直到连接断开
            async for raw_message in self.ws:
                self._handle_business_message(raw_message)
        except websockets.exceptions.ConnectionClosedOK:
            # 匹配服务端正常发送Close帧关闭的场景
            print("检测到服务端主动关闭连接")
            self.ws = None
        except websockets.exceptions.ConnectionClosedError as e:
            # 匹配连接异常中断的场景
            print(f"连接异常断开,原因:{e}")
            self.ws = None
    
  • 修改open_connection方法,在连接建立完成后,把上面的事件消费协程作为后台任务挂到事件循环上持续运行,不要建立完连接就停掉事件循环的调度:
    def open_connection(self, address, firmware_version="103"):
        if self.ws is None:
            loop = asyncio.get_event_loop()
            # 完成WebSocket连接握手
            loop.run_until_complete(self.__async_connect(address))
            # 注册入站事件消费的后台任务,持续监听连接状态
            loop.create_task(self._connection_event_loop())
    
  • 发送业务消息前,先通过连接对象的state属性检查连接是否处于打开状态,同时在send逻辑里捕获ConnectionClosed类的异常,做连接状态的兜底清理。

之前排查的ping_interval=None配置完全不影响这个问题:Ping/Pong是应用层的保活机制,和Close控制帧的解析逻辑完全独立,哪怕关闭了心跳,只要有协程在消费入站队列,收到Close帧时库就会正确更新连接状态。

内容的提问来源于stack exchange,提问作者Kathryn Newbould

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 17:24:03