讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决Python中由于WebSocket连接断开导致的ConnectionClosed?

云芳小哥_8983

云芳小哥_8983

发布时间:2026-08-20 11:18:25

|

985人浏览过

|

来源于php中文网

原创

ConnectionClosed异常源于操作时序错乱而非网络故障,recv()缺失会导致连接被中间设备静默断开而触发ConnectionClosedOK;必须启动接收循环或定时ping()保活,并配对设置ping_interval与ping_timeout以匹配中间设备超时。

如何解决python中由于websocket连接断开导致的connectionclosed?

ConnectionClosed 异常不是连接“出错了”,而是你正在对一个已关闭的连接调用 send() 或 recv() —— 本质是操作时序错乱,不是网络问题本身。

为什么 recv() 漏了会导致 ConnectionClosedOK

asyncio 版 websockets 不会自动维持连接活性。只要没有协程在 await websocket.recv() 或 await websocket.ping(),底层 TCP 连接就会被中间设备(Nginx、防火墙、内核 conntrack)静默掐断,几秒后你再发消息就触发 ConnectionClosedOK(状态码 1000/1001)。

  • 哪怕你只发不收,也必须启动一个最小接收循环:async for _ in websocket: 或 while True: await websocket.recv()
  • 如果真不需要收消息,改用 await asyncio.sleep(1) 配合定时 ping(),但 sleep 时间不能 ≥ ping_interval
  • 绝对不要在 recv() 循环外另起线程或协程调 send(),event loop 会崩,报 RuntimeError: There is no current event loop

ping_interval 和 ping_timeout 必须成对显式设置

只设 ping_interval=45 不够。websockets 默认 ping_timeout=20,但网络抖动或服务端响应慢时,pong 回不来,连接就被强制关闭(错误码 1011 或 ConnectionClosedError)。

  • ping_timeout 要 > 网络 RTT + 服务端处理时间,生产环境建议设为 30
  • ping_interval 要比中间设备空闲超时小至少 10 秒:比如 Nginx proxy_read_timeout=60,那就设 45
  • 两个参数都得显式传给 connect(),例如:await websockets.connect(uri, ping_interval=45, ping_timeout=30)
  • 旧版 websocket-client 的 run_forever() 不适用,asyncio 下必须手动 await websocket.ping()

重连不能裸 try/except ConnectionClosedError

捕获到 ConnectionClosedError 后立刻 await connect(),会导致旧连接 socket 句柄未释放、TCP TIME_WAIT 堆积、重试风暴打挂服务端。

python-script-generator
python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

立即学习“Python免费学习笔记(深入)”;

  • 重连前先确保旧连接已彻底关闭:if websocket.open: await websocket.close()
  • 加退避策略:首次重试延迟 1s,之后指数退避(如 2s、4s、8s),上限建议 30s
  • 限制最大重试次数(如 5 次),超限后抛出异常或通知告警,避免无限循环
  • 不要在 on_close 回调里直接重连——asyncio 下回调可能不在 event loop 中,要用 asyncio.create_task()

ConnectionClosedOK 和 ConnectionClosedError 的区别要盯住状态码

日志里看到 sent 1000 (OK); then received 1000 是 ConnectionClosedOK,说明对方主动发起优雅关闭;而 ConnectionClosedError 通常伴随非 1000/1001 的状态码(如 1006、1011),代表异常中断。

  • 1000:正常关闭,检查业务逻辑是否主动调了 close()
  • 1001:对端离开(如页面关闭、进程退出),客户端应清理资源
  • 1006:无关闭帧,大概率是中间设备强制断连,重点查 Nginx / 防火墙 / conntrack 设置
  • 1011:服务器内部错误,需结合服务端日志定位

真正难调的不是“怎么连上”,而是“怎么让连接不被静默杀死”——所有保活动作(ping、recv、timeout 设置)必须和中间设备的超时值对齐,差 1 秒都可能失效。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1671

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4224

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1669

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

24557

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3007

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3027

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1163

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

C++运算符基础入门
C++运算符基础入门

本专题详细讲解了C++运算符的类型、语法与使用方法,涵盖算术运算符、关系运算符、逻辑运算符、位运算符、赋值运算符、条件运算符及其他特殊运算符,并通过代码示例解析优先级与结合性。

0

2026.10.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn