讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

Python WebSocket 心跳与断线重连机制

小宇吖_1404

小宇吖_1404

发布时间:2026-02-20 13:21:09

|

467人浏览过

|

来源于php中文网

原创

WebSocket断连时on_close未必触发,需主动心跳探测:设ping_interval=30秒、ping_timeout=5秒,捕获socket.timeout等异常并指数退避重连。

python websocket 心跳与断线重连机制

WebSocket 连接突然断开,on_close 没触发?

不是所有断连都会走 on_close —— 网络闪断、NAT 超时、代理静默丢包时,客户端可能收不到 FIN 包,连接就卡在 ESTABLISHED 状态,但服务端早已关闭。这时候靠监听 on_close 做重连,会一直等下去。

真正可靠的做法是:自己发心跳 + 主动探测连接状态。

  • 用 ping_interval(如 websocket-client 库)或手动定时调用 send_ping(),强制触发底层 TCP keepalive 或应用层探测
  • 配合 ping_timeout,超时未收到 pong 就判定为断连,立刻 close 并触发重连逻辑
  • 别依赖操作系统默认的 TCP keepalive(通常 2 小时才触发),它对 WebSocket 场景完全没用

用 websocket-client 实现带心跳的自动重连

这个库本身不自动重连,也不默认开心跳;必须显式配置,且参数名容易写错。

Python Pep Authoring
Python Pep Authoring

依据官方 python/peps仓库规则起草、审阅、编辑或准备 Python 改进提案(PEP),用于处理 PEP 文本和元数据头部。

下载
  • ping_interval=30 表示每 30 秒发一次 ping,单位是秒(不是毫秒)
  • ping_timeout=5 表示发完 ping 后 5 秒内没收到 pong 就报 WebSocketConnectionClosedException
  • 重连不能只靠 try/except WebSocketConnectionClosedException —— 要捕获 socket.timeout、OSError 和 ConnectionRefusedError,这些才是网络层真实失败信号
  • 重连前加 time.sleep(1),避免密集重连被服务端限流;指数退避可选,但至少别立即重试
ws = websocket.WebSocketApp(
    "wss://example.com/ws",
    on_open=lambda ws: print("connected"),
    on_message=lambda ws, msg: handle_msg(msg),
    on_error=lambda ws, err: print(f"error: {err}"),
    on_close=lambda ws, code, reason: print("closed")
)
ws.run_forever(ping_interval=30, ping_timeout=5)

服务端没回 pong?检查 websocket 库版本和配置

Python 服务端用 websocket(非 websockets)时,老版本(

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

  • websocket 库 10.0+ 默认开启 enable_ping_pong=True,但若手动传了 enable_ping_pong=False,客户端 ping 就永远得不到 pong
  • websockets 库则相反:默认响应 ping,但如果你覆盖了 process_request 或用了自定义 protocol,可能意外禁用了 ping handler
  • 用 wscat -c wss://example.com/ws 手动连上去,输入 {"type":"ping"} 看是否返回 {"type":"pong"},快速验证服务端行为

心跳间隔设成 30 秒,为什么还是频繁断连?

30 秒看着合理,但在公网环境下常被中间设备(如运营商 NAT、企业防火墙、CDN)主动 kill 掉空闲连接 —— 它们超时阈值往往在 60–120 秒之间,但有些廉价云 LB 只有 45 秒。

  • 保守起见,心跳间隔建议 ≤ 30 秒,且 ping_timeout ≤ 10 秒,留出网络抖动余量
  • 如果服务端是 Nginx 代理 WebSocket,必须配 proxy_read_timeout 60,否则 Nginx 在 60 秒无数据时直接断连,客户端还蒙在鼓里
  • 移动网络下更敏感:iOS 后台 App 的 WebSocket 会被系统休眠,此时仅靠心跳不够,得结合 onclose 后延迟重连 + 前台唤醒逻辑
心跳机制不是加个 ping_interval 就完事;它和网络路径上的每一层设备、每一行代理配置、每一次异常中断都有关联。最容易忽略的是:你看到的“连接正常”,可能只是 TCP 层没断,而应用层早已失联。

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

超级简历WonderCV

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4147

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

7005

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3998

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

577

2026.01.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

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

精品课程

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

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