flask本身不支持websocket，因其基于同步wsgi协议，无法处理长连接和并发消息；必须使用flask-socketio扩展，并搭配eventlet/gevent异步服务器，否则emit/send会阻塞或静默失败。
Flask 本身不支持 WebSocket，硬上 flask_socketio 是唯一靠谱的落地路径。
为什么不能直接用 Flask + 原生 WebSocket？
Flask 是同步 WSGI 框架，没有事件循环，无法处理 WebSocket 的长连接和并发消息收发。你写个 websocket 路由，启动就报 RuntimeError: WebSocket is not available —— 不是配置错，是根本没这能力。
- WSGI 协议只支持“请求-响应”单次交互，WebSocket 需要持续连接、服务端主动推送、客户端随时发消息
- 试图用
gevent或eventlet“打补丁”也绕不开底层协议限制，最终还得靠封装好的扩展 - 别信“纯 Flask + JS WebSocket”的教程，那只是前端连了，后端根本没接住消息
必须用 flask_socketio，但要注意运行模式
它不是简单 pip install 就完事，后端必须跑在兼容异步的服务器上，否则所有 emit() 和 send() 都会阻塞或静默失败。
- 开发阶段：用
eventlet（推荐）或gevent，安装后加一行import eventlet; eventlet.monkey_patch() - 生产部署：Nginx 需配
upgrade头，uWSGI 不支持 Socket.IO，必须换gunicorn+eventlet工作模式 - 客户端连接地址不是
ws://，而是http://或https://——flask_socketio自动降级协商，强行用ws://会 400
socketio.emit() 的作用域和常见误用
发消息不是无脑调 emit 就行，发给谁、在哪发、什么时候发，直接影响通信逻辑是否成立。
-
socketio.emit('msg', data)：广播给所有已连接客户端（包括发送者自己） -
socketio.send(data)：只发给当前请求上下文里的客户端（常用于连接建立后的欢迎消息） -
socketio.emit('msg', data, to=session_id)：精准推送给某个用户（需提前保存request.sid） - 在非 Socket.IO 上下文里（比如普通 Flask route 或后台线程）调
emit，必须加namespace参数，否则消息消失
前端连接和事件监听不能只写 connect
JS 端看似简单，但漏掉错误监听或重连逻辑，页面一刷新就断连，用户根本不知道发生了什么。
- 连接地址用
io('http://localhost:5000')，不是new WebSocket() - 必须监听
'connect_error'和'reconnect_failed'，否则网络抖动时静默失败 -
socket.on('connect', () => { console.log('sid:', socket.id) })——socket.id是后端request.sid的对应值，用于定向通信 - 发送消息用
socket.emit('chat', {text: 'hi'})，不是socket.send()（后者只走默认事件message）
最常被忽略的是 session 管理：request.sid 在每次连接时重置，如果用户刷新页面，旧 sid 失效，而你还在用缓存里的 sid 推送，消息就石沉大海。真要保活，得结合 JWT 或数据库存映射关系，而不是依赖内存变量。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
