join_room()和leave_room()需在连接后显式调用，room名须从客户端传参动态获取（如data.get('room')），不可硬编码；同一socket可属多房间，切换房间须原子性执行leave_room()再join_room()，避免消息错乱。
Flask-SocketIO 的 join_room() 和 leave_room() 怎么用才不丢消息
多房间本质是靠 Socket.IO 的房间（room）机制隔离广播范围，不是靠自定义路由或 session 判断。必须在连接建立后、收发消息前显式调用 join_room()，否则 emit(..., room=xxx) 会静默失败——没人在那个 room 里，包括刚连上的自己。
常见错误是把房间名硬编码成字符串字面量，比如 join_room("lobby")，结果所有用户挤进同一个房间。实际应从客户端传参中提取房间标识，例如 URL query、JSON 消息字段或 handshake query string：
from flask_socketio import join_room, leave_room
<p>@socketio.on('join')
def on_join(data):
room = data.get('room')
if not room:
return
join_room(room) # 关键：必须调用，且 room 是 str 类型
emit('status', {'msg': f'Joined {room}'}, room=room)注意：join_room() 不触发服务端事件，也不广播给其他人；它只改变当前 socket 的所属房间列表。同一 socket 可同时属于多个 room，但跨 room 发送需分别指定 room=xxx。
客户端如何安全地切换房间而不断连重连
Socket.IO 客户端不能“移动”到另一个 room，只能先 leave_room() 再 join_room()。如果顺序反了（比如先 join 新房再 leave 旧房），会导致短暂时间内用户同时在两个房间收消息，逻辑混乱。
立即学习“Python免费学习笔记（深入）”；
正确做法是在服务端统一处理“换房”动作，客户端只发一次请求：
- 客户端发送
{'action': 'switch', 'from': 'old', 'to': 'new'} - 服务端原子性执行：
leave_room('old')→join_room('new')→emit('joined', ..., room='new') - 避免在客户端用两次
emit分别调 leave/join，网络延迟可能导致状态不一致
另外，room 名建议只含字母、数字、下划线，避免空格或特殊字符——Flask-SocketIO 底层用 Redis 或内存存储 room 映射，非规范命名可能引发 silent failure 或 KeyError。
广播消息时漏掉自己？broadcast=True 和 include_self=False 的区别
默认 emit() 只发给当前 socket 自己；加 broadcast=True 才发给同 room 其他人（不含自己）。但如果你需要“通知全房间，包括刚加入的自己”，就得显式设 include_self=True：
@socketio.on('message')
def handle_message(data):
room = data['room']
# 这样发：别人收到，自己收不到
emit('message', data, room=room, broadcast=True)
<pre class='brush:python;toolbar:false;'># 如果想自己也收到（比如补历史消息），得这样：
emit('message', data, room=room, include_self=True)</pre>broadcast=True 和 include_self=True 可共存，但多数聊天场景不需要——用户发的消息自己本地渲染即可，不必走服务端绕一圈。真正要小心的是误设 broadcast=False 还以为能群发，结果只有自己看到。
生产环境必须关掉 async_mode 默认值
Flask-SocketIO 在开发时默认用 eventlet，但很多 Linux 环境没装，会 fallback 到 threading，而 threading 模式不支持多房间的并发广播，容易卡死或丢包。启动时务必显式指定：
socketio = SocketIO(app, async_mode='eventlet') # 或 'gevent'
对应要 pip install eventlet（推荐）或 gevent，并确保没其他库冲突（比如某些数据库驱动不兼容 eventlet monkey patch）。调试时如果发现房间内部分人收不到消息，先检查 socketio.server.eio.async_mode 的实际值，别信文档默认值。
房间名若来自用户输入，一定要做长度和字符过滤——过长的 room 名会拖慢 Redis 查找，含控制字符可能破坏底层 channel key 格式。这不是功能问题，是上线后才会暴露的稳定性隐患。
