Flask+Flask_SocketIO异常：服务端发事件客户端未接收

核心问题原因 #

1. 事件循环冲突：你用asyncio.run_in_executor将Flask-SocketIO服务丢到子线程启动，而socketio.run()本身会启动eventlet/gevent的事件循环。这导致主线程（asyncio循环）调用make_update时，emit操作不在SocketIO的事件循环上下文里，消息无法正确投递到已连接的客户端。
2. 跨线程emit未适配：make_update从主线程调用，而SocketIO的连接状态由子线程的事件循环管理，直接跨线程调用emit会丢失上下文，无法找到对应的客户端连接。

具体解决方案 #

1. 确保猴子补丁在最顶部加载 #

在项目入口文件的最开始就执行eventlet猴子补丁，覆盖所有标准库：

import eventlet
eventlet.monkey_patch()

2. 修改make_update，用SocketIO后台任务执行emit #

将emit操作包装到SocketIO的start_background_task中，确保操作在SocketIO的事件循环上下文里执行：

def make_update(self, action: typing.Literal["main", "rise", "fall"], y: int | float, x: datetime.datetime) -> None:
    def emit_task():
        try:
            if not self.sandbox:
                emit_x = int(time.mktime(x.timetuple())) * 1000
                self.socketio.emit(action, {"y": y, "x": emit_x}, namespace='/')
            else:
                self.last_time = self.last_time + datetime.timedelta(seconds=self.config["general"]["sandbox"]["interval"])
                emit_x = int(time.mktime(self.last_time.timetuple())) * 1000
                print(f"Sending event: {action}, Y: {y}, X: {emit_x}")
                self.socketio.emit(action, {"y": y, "x": emit_x}, namespace='/')
        except Exception as error:
            print(f"{self.c.Red}ERROR{self.c.R} @MainWebsite.emit_task: {type(error).__name__}: {error}")
    try:
        # 用SocketIO的后台任务执行emit，确保在正确的事件循环中
        self.socketio.start_background_task(emit_task)
    except Exception as error:
        print(f"{self.c.Red}ERROR{self.c.R} @MainWebsite.make_update: {type(error).__name__}: {error}")

3. 优化客户端SocketIO初始化 #

指定使用websocket传输，避免轮询模式可能的兼容性问题：

// 替换原socket初始化代码
const socket = io('/', {
    transports: ['websocket'],
    reconnection: true
});

4. 验证版本兼容性 #

确保服务端Flask-SocketIO与客户端socket.io版本匹配：

• Flask-SocketIO 5.x → 客户端 socket.io 4.x/5.x
• Flask-SocketIO 4.x → 客户端 socket.io 3.x

额外检查点 #

• 确认客户端的onAny监听能捕获所有事件，如果还是没输出，说明事件根本没到达客户端，重点排查服务端emit的上下文问题。
• 启动服务时，确保socketio.run()使用eventlet作为异步引擎（默认就是，但可以显式指定：self.socketio.run(..., async_mode='eventlet')）

内容的提问来源于stack exchange，提问作者Red