讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

怎么在Python中使用Flask-SocketIO实现实时双向通信?

小宇大大_1479

小宇大大_1479

发布时间:2026-11-21 09:40:30

|

549人浏览过

|

来源于php中文网

原创

Flask-SocketIO不能仅靠flask run启动,因其依赖eventlet或gevent异步服务器实现WebSocket升级和长轮询,而flask run基于同步Werkzeug服务器,无法支持异步握手与多路复用,必须改用socketio.run()并显式指定async_mode。

怎么在python中使用flask-socketio实现实时双向通信?

Flask-SocketIO 为什么不能只靠 flask run 启动?

直接用 flask run 启动 Flask 应用时,Socket.IO 的长连接(如 WebSocket 升级、HTTP 轮询回退)会失败,客户端反复触发 connect_error 或卡在 pending 状态。这是因为 flask run 使用的是 Werkzeug 开发服务器,不支持异步握手和多路复用——而 Flask-SocketIO 默认依赖 eventlet 或 gevent 提供的异步 I/O 能力。

必须改用 socketio.run() 启动,并显式指定异步模式:

from flask import Flask
from flask_socketio import SocketIO
<p>app = Flask(<strong>name</strong>)
app.config['SECRET_KEY'] = 'dev-key'
socketio = SocketIO(app, async_mode='eventlet')  # 或 'gevent'</p><p>if <strong>name</strong> == '<strong>main</strong>':
socketio.run(app, host='0.0.0.0', port=5000, debug=True)
  • 不指定 async_mode 时,SocketIO 会按顺序尝试 eventlet → gevent → threading,但后两者在生产中不推荐;线程模式无法处理 WebSocket 升级
  • 若已安装 eventlet 却仍 fallback 到 threading,检查是否误装了 eventlet==0.34.0+ ——该版本与某些 Flask-SocketIO 版本存在兼容问题,建议锁定 eventlet==0.33.3
  • Windows 上若报 ImportError: No module named win32api,是 eventlet 依赖未完整安装,运行 pip install pywin32 后还需手动执行 Scripts/pywin32_postinstall.py -install

客户端如何正确连接并监听事件?

前端必须使用官方 socket.io-client(v4+),且 URL 必须与后端启动地址一致,不能混用 http:// 和 https://,也不能漏掉端口(即使 80/443)。

常见错误是写成:

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

使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中
使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中

当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。

下载
// ❌ 错误:协议或路径不匹配,或用了旧版 client
const socket = io('http://localhost'); // 缺少端口,且未声明命名空间
// ❌ 更糟:引入了 cdn 上的 v2/v3 客户端,与服务端 v5 不兼容

正确写法:

<script src="https://cdn.socket.io/4.7.2/socket.io.min.js"></script>
<script>
  const socket = io('http://localhost:5000', {
    transports: ['websocket', 'polling'], // 显式声明,避免自动降级混乱
  });
<p>socket.on('connect', () => {
console.log('connected:', socket.id);
});</p><p>socket.on('message', (data) => {
console.log('server says:', data);
});
</script>
  • 服务端用 @socketio.on('message') 监听,客户端就用 socket.emit('message', ...) 发;事件名大小写敏感,且不能含空格或特殊字符
  • 若页面部署在 Nginx 后,需配置 proxy_set_header Upgrade $http_upgrade; 和 proxy_set_header Connection "upgrade";,否则 WebSocket 握手被静默拒绝
  • 开发时浏览器控制台看到 WebSocket connection to 'ws://...' failed,优先检查服务端是否启用了 WebSocket(即 async_mode 正确)、Nginx 配置、以及跨域(cors_allowed_origins 参数)

怎么安全地广播消息又不炸掉内存?

socketio.emit() 默认向所有连接客户端广播,如果连接数上千,每秒 emit 一次,很容易压垮服务端或触发客户端重连风暴。更危险的是,在事件回调里调用 socketio.emit() 却没加 room 或 namespace 限定,导致消息意外发给无关用户。

关键控制点:

  • 用 room 隔离逻辑域:用户登录后 join_room(user_id),发消息时 socketio.emit('notify', data, room=user_id),避免全量广播
  • 慎用 include_self=False:默认 True,即发送者自己也会收到;若不需要(比如“你已发送”提示由前端本地处理),显式关掉
  • 大消息体(如 base64 图片)不要直接 emit,先存对象存储,只 emit URL;否则单次 emit 可能阻塞 eventlet 栈达数百毫秒
  • 高频事件(如游戏坐标更新)务必加节流:服务端用 time.time() 记录上次 emit 时间戳,间隔 socket.emit 频率

调试时收不到消息?先查这三处

90% 的“收不到”问题不是代码逻辑错,而是环境链路断在某个环节:

  • 服务端日志里有没有 received event "xxx" from xxx?没有说明客户端根本没发成功,重点查前端 socket.emit() 是否在 connect 回调之后调用
  • 浏览器 Network 面板里,WS 标签页是否建立了 ws 连接?若只有 polling 请求(/socket.io/?EIO=4&transport=polling),说明 WebSocket 被拦截或服务端未启用
  • 服务端 socketio.emit() 调用后,日志有没有 emitting event "xxx"?没有则可能是异步上下文丢失——比如在 threading.Timer 或普通线程里调用,必须用 socketio.start_background_task() 包裹

最常被忽略的是命名空间(namespace)不一致:前后端都得显式声明,比如服务端 @socketio.on('join', namespace='/chat'),前端就得 io('http://...', { path: '/socket.io', namespace: '/chat' })。漏掉这个,两边就在不同频道说话。

热门AI工具

更多
蛙蛙写作

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

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Seko
Seko Hot

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

WorkBuddy

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixTV
PixTV Hot

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

火山引擎

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

豆包大模型

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

DeepSeek

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

相关专题

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

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

1971

2023.07.20

python能做什么
python能做什么

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

5624

2023.07.25

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

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

1909

2023.07.31

python教程
python教程

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

34537

2023.08.03

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

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

4027

2023.08.04

python eval
python eval

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

4027

2023.08.04

scratch和python区别
scratch和python区别

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

1303

2023.08.11

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

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

636

2023.08.10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

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